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
signature.asc
Description: PGP signature
_______________________________________________ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev