rearrange content to fit the new standard layout

Change-Id: I5cbe836cf54f752eb4f93e105ffb49b387440db7
Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454

.gitignore

@@ -41,7 +41,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

@@ -10,12 +10,11 @@ Contents
 .. toctree::
    :maxdepth: 2
 
-   installation
+   install/index
-   api/modules
+   contributor/index
-   usage
+   configuration/index
-   opts
+   user/index
-   contributing
+   reference/index
-   history
 
 Indices and tables
 ==================

doc/source/reference/index.rst

@@ -0,0 +1,10 @@
+.. _using:
+
+=========
+Reference
+=========
+
+.. toctree::
+   :maxdepth: 2
+
+   api/modules

doc/source/user/history.rst

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

doc/source/user/index.rst

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

setup.cfg

@@ -43,6 +43,7 @@ etcd3gw =
 [pbr]
 warnerrors = true
 autodoc_tree_index_modules = True
+api_doc_dir = reference/api
 
 [build_sphinx]
 source-dir = doc/source