Virtual Machine Image Guide: RST conversion

Convert the Virtual Machine Image Guide from DocBook to RST.

Problem description

The Virtual Machine Image Guide will be converted from DocBook to RST for the Mitaka release.

Proposed change

Convert the Virtual Machine Image Guide to RST.





Primary assignee:

  • kato-tomoyuki

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 Virtual Machine Image 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 [image-guide] in the subject, weekly documentation team meeting, and potentially etherpads.