[Openstack-docs] proposed rst-xml automation openstack-manuals blueprint

Sean Roberts seanrob at yahoo-inc.com
Wed Oct 9 23:37:58 UTC 2013


The training-manuals team is proposing a blueprint to implement rst to xml conversion script. This code is used to convert devref project rst documentation into xml that the openstack manuals project can use. The Training-manuals sub-project will use xi:include statements so the converted xml becomes part of the training guides during build. The conversion script will live in the ./training-guide/sources sub directory of the training-manuals sub-project. The converted xml gets placed within ./training-guide/sources/<project> directories. The conversion script will be run at the same time as when the openstack-manuals repo updates are pulled. This will allow the training manuals team to find xml content and include it with the training guides. If the source RST has a bug, then the RST source will be patched, and the XML will get the bug fix through the next run of the conversion script.

Blueprint here https://blueprints.launchpad.net/openstack-manuals/+spec/rst-xml-conversion
Wiki details here https://wiki.openstack.org/wiki/Training-manuals#RST-XML_Conversion_automation

Sean Roberts
Infrastructure Strategy
seanrob at yahoo-inc.com<mailto:seanrob at yahoo-inc.com> (925) 980-4729

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20131009/472ad36d/attachment.html>


More information about the Openstack-docs mailing list