Operations Guide: RST conversion

Operations Guide: RST conversion


Convert the Operations Guide from DocBook to RST.

Problem description

The Operations Guide will be converted from DocBook to RST for the Mitaka release. This conversion is a precursor to reorganising the guide.

Proposed change

Convert the Operations Guide to RST.





Primary assignee:

  • dazzachan

Other contributors:

  • shilla-saebi
  • alexandra-settle
  • kato-tomoyuki

Work Items

  • 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 Operations Guide.
  • Apply the openstackdocstheme template to the guide.
  • Import translations from the old guide to the new guide.


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


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


  • Discussion can occur using any official medium including IRC in #openstack-doc, the openstack-docs mailing list with [ops-guide] in the subject, weekly Ops Guide specialty team meeting, 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.