[aerogear-dev] asciidoc vs markdown

Summers Pittman supittma at redhat.com
Mon Mar 9 11:05:35 EDT 2015


On 03/09/2015 09:47 AM, Andres Galante wrote:
> I'll probably never have to write a guide, but after editing almost all guides to style them better there is one thing about asciidoc that I like better than markdown: Tips
>
> Inserting tips, warning and info boxes in ascii is super easy.
>
> Almost all guides are written in asciidoc, the change to asciidoc would be much easier.
>
> Having said that, I like markdown better, but again, I am not an user :)
I think we were supposed to be migrating TO asciidoc.

I believe the reasons for asciidoc were 1) We employed the asciidoc guy 
and 2) There is/was a requirement to support some doc format that 
asciidoc exported to but markdown did not.

I may be insane though.
>
>
>
> ----- Original Message -----
> From: "Corinne Krych" <corinnekrych at gmail.com>
> To: "AeroGear Developer Mailing List" <aerogear-dev at lists.jboss.org>
> Sent: Monday, March 9, 2015 10:36:28 AM
> Subject: Re: [aerogear-dev] asciidoc vs markdown
>
> +1 on having one or the other. I find it confusing to have to switch beetween syntax.
> I’m ok with whatever we choose but having only one would be neat.
>
> ++
> Corinne
>> On 09 Mar 2015, at 14:33, Erik Jan de Wit <edewit at redhat.com> wrote:
>>
>> I know we’ve talked about it before (although I’m not sure what was decided), but with the new site coming on quite nicely I would like to discuss this one more time. Right now we have markdown and asciidoc mixed, I think it would be good to choose one or the other. We can convert the documents automatically.
>>
>> So what do you think,
>> 	Erik Jan
>> _______________________________________________
>> aerogear-dev mailing list
>> aerogear-dev at lists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/aerogear-dev
>
> _______________________________________________
> aerogear-dev mailing list
> aerogear-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/aerogear-dev
>
> _______________________________________________
> aerogear-dev mailing list
> aerogear-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/aerogear-dev


-- 
Summers Pittman
>>Phone:404 941 4698
>>Java is my crack.



More information about the aerogear-dev mailing list