Open Stack

I totally agree that ASCII is easier for everybody.
The fact is OpenStack HA Guide is the only one which does not follow
recommendations written here :

https://wiki.openstack.org/wiki/Documentation/HowTo#docs.openstack.org_.28DocBook_5.29


Now, here my point of view :

- Why I like ASCII : because as you say, it's easier to write with this
language.
- Why I send this email : just because I don't like to be alone in
writing with ASCII while others use DocBook.

If nobody contradict us, I would suggest keeping ASCII for this guide.


Cheers,

Emilien Macchi
----------------------------------------------------
# OpenStack Engineer
// eNovance Inc.              http://enovance.com
// ✉ emilien at enovance.com     ☎ +33 (0)1 49 70 99 80
// 10 rue de la Victoire 75009 Paris

On 05/01/2013 07:45 PM, Florian Haas wrote:
> 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
>


-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 553 bytes
Desc: OpenPGP digital signature
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130501/afa26e1e/attachment.pgp>