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

Co-Authored-By: Eduardo Gonzalez <dabarren@gmail.com>
Change-Id: I3a7c0ed204ee1e9060b5325f20622afe9a5e3040

doc/source/contributor/index.rst

@@ -0,0 +1,10 @@
+Developer Docs
+==============
+
+.. toctree::
+   :maxdepth: 1
+
+   CONTRIBUTING
+   vagrant-dev-env
+   running-tests
+   bug-triage

doc/source/index.rst

@@ -34,57 +34,26 @@ refer to the `Kolla image documentation
 <https://docs.openstack.org/kolla/latest/>`_.
 
 
-Overview
+User Guides
-========
+===========
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
 
-   deployment-philosophy
+   user/index
-   production-architecture-guide
-   quickstart
-   multinode
-   multi-regions
-   advanced-configuration
-   operating-kolla
-   security
-   kolla-for-openstack-development
-   troubleshooting
 
-Services
+Reference
-========
+=========
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
 
-   ceph-guide
+   reference/index
-   central-logging-guide
-   external-ceph-guide
-   cinder-guide
-   cinder-guide-hnas
-   designate-guide
-   hyperv-guide
-   ironic-guide
-   manila-guide
-   manila-hnas-guide
-   nova-fake-driver
-   swift-guide
-   bifrost
-   networking-guide
-   kuryr-guide
-   zun-guide
-   osprofiler-guide
-   skydive-guide
-   vmware-guide
-   tacker-guide
 
 Developer Docs
 ==============
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
 
-   CONTRIBUTING
+   contributor/index
-   vagrant-dev-env
-   running-tests
-   bug-triage

doc/source/reference/bifrost.rst

@@ -64,11 +64,11 @@ Preparation
 Prepare the Control Host
 ------------------------
 
-Follow the **Install dependencies** section of the :doc:`quickstart` guide
+Follow the **Install dependencies** section of the :doc:`../user/quickstart`
-instructions to set up kolla and kolla-ansible dependencies.  Follow the
+guide instructions to set up kolla and kolla-ansible dependencies.  Follow
-instructions in either the **Install kolla for development** section or the
+the instructions in either the **Install kolla for development** section or
-**Install kolla for deployment or evaluation** section to install kolla and
+the **Install kolla for deployment or evaluation** section to install kolla
-kolla-ansible.
+and kolla-ansible.
 
 Prepare the Deployment Host
 ---------------------------
@@ -179,8 +179,8 @@ host on which bifrost is deployed.
 Prepare Kolla-Ansible Configuration
 -----------------------------------
 
-Follow the instructions in :doc:`quickstart` to prepare kolla-ansible's global
+Follow the instructions in :doc:`../user/quickstart` to prepare kolla-ansible's
-configuration file ``globals.yml``.  For bifrost, the
+global configuration file ``globals.yml``.  For bifrost, the
 ``bifrost_network_interface`` variable should be set to the name of the
 interface that will be used to provision bare metal cloud hosts if this is
 different than ``network_interface``.  For example to use ``eth1``:

doc/source/reference/index.rst

@@ -0,0 +1,26 @@
+Reference
+=========
+
+.. toctree::
+   :maxdepth: 1
+
+   ceph-guide
+   central-logging-guide
+   external-ceph-guide
+   cinder-guide
+   cinder-guide-hnas
+   designate-guide
+   hyperv-guide
+   ironic-guide
+   manila-guide
+   manila-hnas-guide
+   nova-fake-driver
+   swift-guide
+   bifrost
+   networking-guide
+   kuryr-guide
+   zun-guide
+   osprofiler-guide
+   skydive-guide
+   vmware-guide
+   tacker-guide

doc/source/user/index.rst

@@ -0,0 +1,16 @@
+User Guides
+===========
+
+.. toctree::
+   :maxdepth: 1
+
+   deployment-philosophy
+   production-architecture-guide
+   quickstart
+   multinode
+   multi-regions
+   advanced-configuration
+   operating-kolla
+   security
+   kolla-for-openstack-development
+   troubleshooting

setup.cfg

@@ -53,7 +53,7 @@ setup-hooks =
 [build_sphinx]
 all_files = 1
 build-dir = doc/build
-source-dir = doc
+source-dir = doc/source
 warning-is-error = 1
 
 [build_releasenotes]