rearrange existing documentation to fit the new standard layout

For more detail, see the doc migration spec:
http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html
There is also the recent status of the work posted in the dev ML:
http://lists.openstack.org/pipermail/openstack-dev/2017-July/119221.html

Change-Id: I1e728fc0bc671150d826747010eb980176f0cc13

.gitignore

@@ -50,7 +50,7 @@ ChangeLog
 # Editors
 *~
 .*.swp
-/doc/source/api/
+/doc/source/reference/api/
 
 # reno build
 releasenotes/build

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

@@ -8,29 +8,12 @@ and APIs.
 .. toctree::
    :maxdepth: 2
 
-   installation
-   usage
-   contributing
+   install/index
+   user/index
+   contributor/index
+   reference/index
 
-Code Documentation
-==================
-
-.. toctree::
-   :maxdepth: 1
-
-   api/autoindex
-
-Release Notes
-=============
-
-.. toctree::
-   :maxdepth: 1
-
-   history
-
-
-Indices and tables
-==================
+.. rubric:: Indices and tables
 
 * :ref:`genindex`
 * :ref:`modindex`

doc/source/reference/index.rst

@@ -0,0 +1,9 @@
+=============
+API Reference
+=============
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   api/*

doc/source/user/history.rst

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

doc/source/user/index.rst

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

setup.cfg

@@ -50,6 +50,7 @@ autodoc_index_modules = 1
 autodoc_exclude_modules =
     oslo_vmware._i18n
     oslo_vmware.tests.*
+api_doc_dir = reference/api
 
 [wheel]
 universal = 1