Architecture Design Guide: RST conversion

Convert the Architecture Design Guide from DocBook to RST.

Problem description

The Architecture Design 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 Architecture Design Guide to RST.





Primary assignee:

  • shilla-saebi

Other contributors:

  • dazzachan
  • alexandra-settle
  • kato-tomoyuki
  • berendt

Work Items

  • 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 Architecture Design Guide.
  • Apply the openstackdocstheme template to the guide.


The main dependency is on 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 [arch-guide] in the subject, weekly Ops Guide specialty team meeting, weekly documentation team meeting, and potentially etherpads.