Use more standard docs folder

docs/Makefile

@@ -0,0 +1,12 @@
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SOURCEDIR     = source
+BUILDDIR      = build
+
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/source/changelog.rst

@@ -0,0 +1,5 @@
+*********
+Changelog
+*********
+
+.. include:: ../../CHANGELOG.rst

docs/source/code-of-conduct.rst

@@ -0,0 +1,6 @@
+.. _code-of-conduct:
+
+Code of Conduct
+***************
+
+.. include:: ../../CODE_OF_CONDUCT.rst

docs/source/conf.py

@@ -0,0 +1,8 @@
+author = 'decentral1se'
+copyright = '2019, decentral1se'
+html_static_path = ['_static']
+html_theme = 'sphinx_rtd_theme'
+master_doc = 'index'
+project = 'flat-tree'
+templates_path = ['_templates']
+extensions = ['sphinx.ext.autodoc', 'sphinx_autodoc_typehints']

docs/source/contribute.rst

@@ -0,0 +1,5 @@
+**********
+Contribute
+**********
+
+.. include:: ../../CONTRIBUTING.rst

docs/source/example.rst

@@ -0,0 +1,24 @@
+*******
+Example
+*******
+
+You can represent a binary tree in a simple flat list using the following structure.
+
+.. code-block:: python
+
+    """
+
+         3
+     1       5
+   0   2   4   6  ...
+
+   """
+
+This module exposes a series of functions to help you build and maintain this data structure.
+
+.. code-block:: python
+
+    from flat_tree import FlatTreeAccessor
+
+    tree_access = FlatTreeAccessor()
+    tree_access.index(1, 0)  # get index @ depth: 1, offset: 0

docs/source/index.rst

@@ -0,0 +1,15 @@
+.. include:: ../../README.rst
+   :end-before: _documentation
+
+.. toctree::
+   :maxdepth: 1
+   :hidden:
+
+   install
+   upgrade
+   example
+   modules-api
+   other-impls
+   contribute
+   changelog
+   code-of-conduct

docs/source/install.rst

@@ -0,0 +1,11 @@
+*******
+Install
+*******
+
+.. code-block:: bash
+
+    $ pip install flat-tree
+
+.. note::
+
+    Only Python >= 3.6 is supported.

docs/source/modules-api.rst

@@ -0,0 +1,11 @@
+.. _modules_api:
+
+***********
+Modules API
+***********
+
+.. automodule:: flat_tree.accessor
+   :members:
+
+.. automodule:: flat_tree.iterator
+   :members:

docs/source/other-impls.rst

@@ -0,0 +1,14 @@
+.. _other-implementations:
+
+Other Implementations
+*********************
+
+* `mafintosh/flat-tree`_
+* `datrs/flat-tree`_
+* `bcomnes/flattree`_
+* `datcxx/flat-tree`_
+
+.. _mafintosh/flat-tree: https://github.com/mafintosh/flat-tree
+.. _datrs/flat-tree: https://github.com/datrs/flat-tree
+.. _bcomnes/flattree: https://github.com/bcomnes/flattree
+.. _datcxx/flat-tree: https://github.com/datcxx/flat-tree

docs/source/upgrade.rst

@@ -0,0 +1,7 @@
+*******
+Upgrade
+*******
+
+.. code-block:: bash
+
+    $ pip install --upgrade flat-tree