<div dir="ltr">I'm fine with keeping ASCIIdoc for this guide. <div><br></div><div style>We take docs in any format and "eventually" convert them to docbook, even if it's under the covers. So if you sense that docbook is the standard, it's because we need it for the eventual consistent output. Markdown or RST to Docbook is not great but ASCIIdoc to docbook is great. </div>

<div style><br></div><div style>Anne</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, May 1, 2013 at 3:49 PM, Emilien Macchi <span dir="ltr"><<a href="mailto:emilien.macchi@enovance.com" target="_blank">emilien.macchi@enovance.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">I totally agree that ASCII is easier for everybody.<br>
The fact is OpenStack HA Guide is the only one which does not follow<br>
recommendations written here :<br>
<br>
<a href="https://wiki.openstack.org/wiki/Documentation/HowTo#docs.openstack.org_.28DocBook_5.29" target="_blank">https://wiki.openstack.org/wiki/Documentation/HowTo#docs.openstack.org_.28DocBook_5.29</a><br>
<br>
<br>
Now, here my point of view :<br>
<br>
- Why I like ASCII : because as you say, it's easier to write with this<br>
language.<br>
- Why I send this email : just because I don't like to be alone in<br>
writing with ASCII while others use DocBook.<br>
<br>
If nobody contradict us, I would suggest keeping ASCII for this guide.<br>
<br>
<br>
Cheers,<br>
<div class="im HOEnZb"><br>
Emilien Macchi<br>
----------------------------------------------------<br>
# OpenStack Engineer<br>
// eNovance Inc.              <a href="http://enovance.com" target="_blank">http://enovance.com</a><br>
// ✉ <a href="mailto:emilien@enovance.com">emilien@enovance.com</a>     ☎ <a href="tel:%2B33%20%280%291%2049%2070%2099%2080" value="+33149709980">+33 (0)1 49 70 99 80</a><br>
// 10 rue de la Victoire 75009 Paris<br>
<br>
</div><div class="HOEnZb"><div class="h5">On 05/01/2013 07:45 PM, Florian Haas wrote:<br>
> On 05/01/2013 06:47 PM, Emilien Macchi wrote:<br>
>> Hi,<br>
>><br>
>><br>
>> Is anyone against the idea to convert openstack-ha guide from asciidoc<br>
>> to docbook (which is the official language) ?<br>
>><br>
>><br>
>> Cheers<br>
>><br>
> I would object, because we have few enough doc writers as it is, and<br>
> switching to DocBook is going to raise the barrier to entry for new<br>
> contributors, not lower it.<br>
><br>
> However, don't let that stop you from trying to convince me. :) What are<br>
> your points in favor of DocBook?<br>
><br>
> Mind you, I wrote straight-up DocBook for years, and then converted to<br>
> AsciiDoc because I found positively nothing that was both useful in<br>
> DocBook, and un-expressible in AsciiDoc.<br>
><br>
> What do others think?<br>
><br>
> Cheers,<br>
> Florian<br>
><br>
<br>
<br>
</div></div></blockquote></div><br></div>