Command-Line Interface Reference: RST conversion

Convert Command-Line Interface Reference from DocBook to ReST.

Problem description

Command-Line Interface Reference uses old DocBook format. Currently, we use the new docs theme with ReST format.

Proposed change

Convert the Command-Line Interface Reference from DocBook to ReST including the automation scripts.





Primary assignee:

  • kato-tomoyuki

Work Items

  • Stop updating the entire guide.
  • Modify the output by the command reference generation tool from DocBook to ReST.
  • Convert the manual contents from DocBook to Rest.
  • Track changes in wiki.
  • Update our build infrastructure so that Sphinx is used for publishing the Command-Line Interface Reference.
  • 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 [cli-ref] in the subject, weekly documentation team meeting, and potentially etherpads.