Group advanced topics by type

We're getting to have a lot of "advanced" docs, and most of those
fit into one of a few categories.  This change separates the
advanced topics into one of the following categories:

-Feature Config
-Baremetal Node Config
-Backend Config
-Custom Config
-Developer Docs

Single image building is moved to post deployment since it's not
a normal part of the initial deployment.

Change-Id: I14e31469a533efbfe3c18c4bd11da8b3f8f455e6

doc/source/advanced_deployment/advanced_deployment.rst

@@ -6,29 +6,7 @@ In this chapter you will find advanced deployment of various |project| areas.
 
 .. toctree::
 
-   node_states
+   features
-   root_device
+   baremetal_nodes
-   build_single_image
+   backends
-   introspect_single_node
+   custom
-   profile_matching
-   ready_state
-   introspection_data
-   node_config
-   node_specific_hieradata
-   extra_config
-   template_deploy
-   network_isolation
-   network_isolation_virt
-   high_availability
-   deploy_manila
-   cinder_custom_backend
-   cinder_netapp
-   ceph_config
-   neutron_midonet
-   ssl
-   node_placement
-   ops_tools
-   # TODO(bnemec): Add a new developer section for the docs that aren't
-   # relevant to regular users.
-   tripleo.sh
-   in_progress_review

doc/source/advanced_deployment/backends.rst

@@ -0,0 +1,14 @@
+Backend Configuration
+=====================
+
+Documentation on how to enable and configure various backends available for
+OpenStack projects.
+
+
+.. toctree::
+
+   deploy_manila
+   cinder_custom_backend
+   cinder_netapp
+   ceph_config
+   neutron_midonet

doc/source/advanced_deployment/baremetal_nodes.rst

@@ -0,0 +1,16 @@
+Baremetal Node Configuration
+============================
+
+Documentation on how to do advanced configuration of baremetal nodes in
+|project|.
+
+
+.. toctree::
+
+
+   node_states
+   root_device
+   introspect_single_node
+   profile_matching
+   ready_state
+   introspection_data

doc/source/advanced_deployment/custom.rst

@@ -0,0 +1,12 @@
+Custom Configurations
+=====================
+
+Documentation on how to deploy custom configurations with |project|.
+
+
+.. toctree::
+
+   node_config
+   node_specific_hieradata
+   extra_config
+   template_deploy

doc/source/advanced_deployment/features.rst

@@ -0,0 +1,16 @@
+Feature Configuration
+=====================
+
+Documentation on how to enable and configure various features available in
+|project|.
+
+
+.. toctree::
+
+
+   network_isolation
+   network_isolation_virt
+   ssl
+   node_placement
+   ops_tools
+   high_availability

doc/source/basic_deployment/basic_deployment_cli.rst

@@ -159,7 +159,7 @@ non-root user that was used to install the undercloud.
 
      It is also possible to use this functionality to use an in-progress review
      as part of the overcloud image build.  See
-     :doc:`../advanced_deployment/in_progress_review` for details.
+     :doc:`../developer/in_progress_review` for details.
 
   ::
 
@@ -169,7 +169,7 @@ non-root user that was used to install the undercloud.
     This command will build **overcloud-full** images (\*.qcow2, \*.initrd,
     \*.vmlinuz) and **ironic-python-agent** images (\*.initramfs, \*.kernel)
 
-    To rebuild only a single image, see :doc:`../advanced_deployment/build_single_image`.
+    To rebuild only a single image, see :doc:`../post_deployment/build_single_image`.
 
 Upload Images
 -------------

doc/source/developer/developer.rst

@@ -0,0 +1,11 @@
+Developer Documentation
+=======================
+
+Documentation of developer-specific options in |project|.
+
+
+.. toctree::
+
+   tripleo.sh
+   in_progress_review
+   tht_walkthrough/tht_walkthrough

doc/source/index.rst

@@ -12,10 +12,13 @@ Contents:
    environments/environments
    installation/installation
    basic_deployment/basic_deployment_cli
-   advanced_deployment/advanced_deployment
    post_deployment/post_deployment
+   advanced_deployment/features
+   advanced_deployment/baremetal_nodes
+   advanced_deployment/backends
+   advanced_deployment/custom
    troubleshooting/troubleshooting
-   tht_walkthrough/tht_walkthrough
+   developer/developer
    contributions/contributions
 
 

doc/source/installation/installing.rst

@@ -89,7 +89,7 @@ Installing the Undercloud
 
      It is also possible to use this functionality to use an in-progress review
      as part of the undercloud install.  See
-     :doc:`../advanced_deployment/in_progress_review` for details.
+     :doc:`../developer/in_progress_review` for details.
 
   .. admonition:: SSL
      :class: ssl

doc/source/post_deployment/post_deployment.rst

@@ -13,4 +13,5 @@ In this chapter you will find advanced management of various |project| areas.
    replace_controller
    vm_snapshot
    package_update
+   build_single_image
    backup_restore_undercloud