Browse Source

include sample config file in docs

Leverage oslo.config to rebuild our sample config file in docs.

Change-Id: I359e63fad43a5fcde4fe30a97cbed8f4f71961c5
changes/05/510205/5
ricolin 4 years ago
committed by Zane Bitter
parent
commit
46d1e89c27
  1. 3
      .gitignore
  2. 5
      doc/source/conf.py
  3. 3
      doc/source/configuration/index.rst
  4. 12
      doc/source/configuration/sample_config.rst

3
.gitignore

@ -35,3 +35,6 @@ doc/source/_static/heat.policy.yaml.sample
# Files created by releasenotes build
releasenotes/build
# sample config included in docs
doc/source/_static/heat.conf.sample

5
doc/source/conf.py

@ -78,6 +78,7 @@ extensions = ['sphinx.ext.autodoc',
'sphinx.ext.viewcode',
'sphinx.ext.doctest',
'openstackdocstheme',
'oslo_config.sphinxconfiggen',
'oslo_policy.sphinxext',
'oslo_policy.sphinxpolicygen',
'ext.resources',
@ -88,6 +89,10 @@ extensions = ['sphinx.ext.autodoc',
policy_generator_config_file = '../../etc/heat/heat-policy-generator.conf'
sample_policy_basename = '_static/heat'
# oslo_config.sphinxconfiggen options
config_generator_config_file = '../../config-generator.conf'
sample_config_basename = '_static/heat'
# openstackdocstheme options
repository_name = 'openstack/heat'
bug_project = 'heat'

3
doc/source/configuration/index.rst

@ -9,4 +9,5 @@ Configuring Heat
clients.rst
config-options.rst
logs.rst
sample_policy.rst
sample_config.rst
sample_policy.rst

12
doc/source/configuration/sample_config.rst

@ -0,0 +1,12 @@
=========================
Heat Configuration Sample
=========================
The following is a sample heat configuration for adaptation and use. It is
auto-generated from heat when this documentation is built, so if you are
having issues with an option, please compare your version of heat with the
version of this documentation.
The sample configuration can also be downloaded in `file form <../_static/heat.conf.sample>`_.
.. literalinclude:: ../_static/heat.conf.sample
Loading…
Cancel
Save