[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