[doc-migration] Add install and configuration folders

Change-Id: I0e760acd62d1e9082d0e7ec0f3c96c6839a7ef6d
Close-Bug: #1706194

doc/source/conf.py

@@ -24,6 +24,7 @@ extensions = [
     'sphinx.ext.autodoc',
     'sphinx.ext.graphviz',
     'openstackdocstheme',
+    'oslo_config.sphinxconfiggen',
 ]
 
 # autodoc generation is a bit aggressive and a nuisance when doing heavy
@@ -41,6 +42,9 @@ repository_name = 'openstack/zun'
 bug_project = 'zun'
 bug_tag = ''
 
+config_generator_config_file = '../../etc/zun/zun-config-generator.conf'
+sample_config_basename = '_static/zun'
+
 # General information about the project.
 project = u'zun'
 copyright = u'2013, OpenStack Foundation'

doc/source/configuration/sample-config.rst

@@ -0,0 +1,13 @@
+=========================
+Zun Configuration Options
+=========================
+
+The following is a sample Zun configuration for adaptation and use. It is
+auto-generated from Zun when this documentation is built, so
+if you are having issues with an option, please compare your version of
+Zun with the version of this documentation.
+
+The sample configuration can also be viewed in :download:`file form
+</_static/zun.conf.sample>`.
+
+.. literalinclude:: /_static/zun.conf.sample

doc/source/index.rst

@@ -32,6 +32,21 @@ Contributor Guide
 
    contributor/index
 
+Installation Guide
+------------------
+.. toctree::
+   :maxdepth: 1
+
+   install/index
+
+Sample Configuration File
+-------------------------
+
+.. toctree::
+    :maxdepth: 1
+
+    configuration/sample-config
+
 Indices and tables
 ------------------
 

doc/source/install/index.rst

@@ -0,0 +1,6 @@
+======================
+Zun Installation Guide
+======================
+
+TODO: There is currently no installation guide for Zun. The work will be
+tracked here: https://blueprints.launchpad.net/zun/+spec/zun-installation-guide