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.