rearrange content to fit the new standard layout

Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454
Change-Id: Ic1cf3f4b0510d18961d3d15d7776aeeebb071193

.gitignore

@@ -44,7 +44,7 @@ output/*/index.html
 
 # Sphinx
 doc/build
-/doc/source/api/
+/doc/source/reference/api/
 
 # pbr generates these
 AUTHORS

doc/source/contributor/index.rst

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

doc/source/history.rst

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

doc/source/index.rst

@@ -5,29 +5,10 @@ oslotest -- OpenStack Testing Framework and Utilities
 .. toctree::
    :maxdepth: 2
 
-   installation
+   install/index
-   testing
+   contributor/index
-   features
+   user/index
-   cross-testing
+   reference/index
-   debugging
-   resources
-   contributing
-
-API
-===
-
-.. toctree::
-   :maxdepth: 1
-
-   api/autoindex
-
-Release Notes
-=============
-
-.. toctree::
-   :maxdepth: 1
-
-   history
 
 Indices and tables
 ==================

doc/source/reference/index.rst

@@ -0,0 +1,9 @@
+.. _using:
+
+API
+===
+
+.. toctree::
+   :maxdepth: 1
+
+   api/autoindex

doc/source/user/history.rst

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

doc/source/user/index.rst

@@ -0,0 +1,13 @@
+==============
+Using oslotest
+==============
+
+.. toctree::
+   :maxdepth: 2
+
+   features
+   debugging
+   testing
+   cross-testing
+   resources
+   history

setup.cfg

@@ -37,6 +37,9 @@ upload-dir = doc/build/html
 
 [pbr]
 autodoc_index_modules = true
+api_doc_dir = reference/api
+autodoc_exclude_modules =
+    oslotest.tests.*
 
 [wheel]
 universal = true