openstack-manuals/doc/contributor-guide/source/docbook-conv.rst

DocBook formatting conventions

OpenStack documentation uses either DocBook or ReStructured Text (RST) syntax.

For the DocBook formatting conventions, refer to the Documentation/Markup conventions page.

Currently the Documentation team is working on the conversion from DocBook to ReStructured Text (RST). For more information on the conversion, see the Documentation/Migrate page.

The guides to be converted for the Mitaka release are:

• Architecture guide
• Operations guide