rearrange existing documentation to fit the new standard layout

Change-Id: I56d60de2c3a8aefa2df834634ff5e6c068d868d4

doc/source/contributor/index.rst

@@ -2,4 +2,4 @@
 Contributing
 ============
 
-.. include:: ../../CONTRIBUTING.rst
+.. include:: ../../../CONTRIBUTING.rst

doc/source/history.rst

@@ -1,2 +0,0 @@
-.. include:: ../../ChangeLog
-

doc/source/index.rst

@@ -6,19 +6,10 @@ Code from the future, delivered to you in the **now**.
 .. toctree::
    :maxdepth: 2
 
-   features
+   user/index
-   api
+   reference/index
-   installation
+   install/index
-   examples
+   contributor/index
-   contributing
-
-History
-=======
-
-.. toctree::
-   :maxdepth: 2
-
-   history
 
 Indices and tables
 ==================

doc/source/reference/index.rst

@@ -1,6 +1,6 @@
-===
+=============
-API
+API Reference
-===
+=============
 
 ---------
 Executors

doc/source/user/history.rst

@@ -0,0 +1,2 @@
+.. include:: ../../../ChangeLog
+

doc/source/user/index.rst

@@ -0,0 +1,15 @@
+==============
+Using futurist
+==============
+
+.. toctree::
+   :maxdepth: 2
+
+   features
+   examples
+
+.. history contains a lot of sections, toctree with maxdepth 1 is used.
+.. toctree::
+   :maxdepth: 1
+
+   history

tox.ini

@@ -27,7 +27,7 @@ commands = python setup.py test --coverage --testr-args='{posargs}'
 commands =
     python setup.py testr --slowest --testr-args='{posargs}'
     sphinx-build -b doctest doc/source doc/build
-    doc8 --ignore-path "doc/source/history.rst" doc/source
+    doc8 --ignore-path "doc/source/user/history.rst" doc/source
 
 [testenv:docs]
 commands = python setup.py build_sphinx