Operations Guide: RST conversion¶
https://blueprints.launchpad.net/openstack-manuals/+spec/ops-guide-rst
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.
Implementation¶
Assignee(s)¶
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.
Dependencies¶
The main dependency is on docs.openstack.org infrastructure updates.
Testing¶
- Test the new HTML design on the following browsers/operating systems:
- Chrome on Ubuntu, Fedora, Mac, Windows
- Firefox on Ubuntu, Fedora, Mac, Windows
References¶
- 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.
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.