[openstack-dev] [Openstack-docs] [Heat][Documentation] Heat template documentation

Julien Danjou julien at danjou.info
Wed May 28 08:05:16 UTC 2014


On Tue, May 27 2014, Gauvain Pocentek wrote:

> So my feeling is that we should work on the tools to convert RST (or
> whatever format, but RST seems to be the "norm" for openstack projects) to
> docbook, and generate our online documentation from there. There are tools
> that can help us doing that, and I don't see an other solution that would
> make us move forward.
>
> Anne, you talked about experimenting with the end user guide, and after the
> discussion and the technical info brought by Doug, Steve and Steven, I now
> think it is worth trying.

I think it's a very good idea.

FWIW, AsciiDoc¹ has a nice markup format that can be converted to
Docbook. I know it's not RST, but it's still better than writing XML
IMHO.


¹  http://www.methods.co.nz/asciidoc/

-- 
Julien Danjou
# Free Software hacker
# http://julien.danjou.info
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 832 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20140528/602be905/attachment.pgp>


More information about the OpenStack-dev mailing list