Configuration Reference: RST conversion

Configuration Reference: RST conversion

https://blueprints.launchpad.net/openstack-manuals/+spec/config-ref-rst

Convert the Configuration Reference from DocBook to RST.

Problem description

The Configuration Reference will be converted from DocBook to RST for the Mitaka release. The tools generating the configuration options tables will be modified to generate RST tables instead of docbook tables.

Proposed change

Convert the Configuration Reference to RST.

Update the autohelp.py, diff_branches.py and extract_swift_flags.py scripts to generate the configuration options tables.

Alternatives

None

Implementation

Assignee(s)

Primary assignee:

  • gpocentek

Work Items

  • Update the openstack-doc-tools scripts to support RST output.
  • Convert content from DocBook to RST.
  • Ensure bug fix proposals are included in DocBook and RST during the conversion process.
  • Track changes in wiki.
  • Update our build infrastructure so that Sphinx is used for publishing the Configuration Reference.
  • Apply the openstackdocstheme template to the guide.
  • Import translations from the old guide to the new guide.

Dependencies

The main dependency is on docs.openstack.org infrastructure updates.

Testing

  • Test the new HTML design on the following browsers/operating systems:
    • Chrome on Ubuntu, Fedora, Mac, Windows
    • Firefox on Ubuntu, Fedora, Mac, Windows

References

  • Discussion can occur using any official medium including IRC in #openstack-doc, the openstack-docs mailing list with [config-ref] in the subject, weekly documentation team meeting, and potentially etherpads.
Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

docs-specs 0.0.1.dev182