rearrange content to fit the new standard layout

Change-Id: Idaa0dde5e4fd14213ae1611560897a27e9f72514
Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454

.gitignore

@@ -18,4 +18,4 @@ ChangeLog
 .project
 .pydevproject
 oslo.db.egg-info/
-doc/source/api
+doc/source/reference/api

doc/source/contributing.rst

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

doc/source/contributor/index.rst

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

doc/source/history.rst

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

doc/source/index.rst

@@ -9,19 +9,10 @@ utils.
 .. toctree::
    :maxdepth: 2
 
-   installation
-   opts
-   usage
-   contributing
-   history
-
-API Documentation
-=================
-
-.. toctree::
-   :maxdepth: 1
-
-   api/autoindex
+   install/index
+   contributor/index
+   user/index
+   reference/index
 
 Indices and tables
 ==================

doc/source/reference/index.rst

@@ -0,0 +1,18 @@
+.. _using:
+
+=========
+Reference
+=========
+
+.. toctree::
+   :maxdepth: 2
+
+   opts
+
+API
+===
+
+.. toctree::
+   :maxdepth: 1
+
+   api/autoindex

doc/source/user/history.rst

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

doc/source/user/index.rst

@@ -0,0 +1,9 @@
+==============
+ Using oslo.db
+==============
+
+.. toctree::
+   :maxdepth: 2
+
+   usage
+   history

setup.cfg

@@ -92,5 +92,6 @@ output_file = oslo_db/locale/oslo_db.pot
 [pbr]
 warnerrors = True
 autodoc_index_modules = True
+api_doc_dir = reference/api
 autodoc_exclude_modules =
    oslo_db.tests.*