[Openstack-docs] [ha-guide] Conversion to docbook

Florian Haas florian at hastexo.com
Wed May 1 17:45:44 UTC 2013


On 05/01/2013 06:47 PM, Emilien Macchi wrote:
> Hi,
> 
> 
> Is anyone against the idea to convert openstack-ha guide from asciidoc
> to docbook (which is the official language) ?
> 
> 
> Cheers
> 

I would object, because we have few enough doc writers as it is, and
switching to DocBook is going to raise the barrier to entry for new
contributors, not lower it.

However, don't let that stop you from trying to convince me. :) What are
your points in favor of DocBook?

Mind you, I wrote straight-up DocBook for years, and then converted to
AsciiDoc because I found positively nothing that was both useful in
DocBook, and un-expressible in AsciiDoc.

What do others think?

Cheers,
Florian




More information about the Openstack-docs mailing list