[aerogear-dev] asciidoc vs markdown

Andres Galante agalante at redhat.com
Mon Mar 9 09:47:12 EDT 2015


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 :)



----- 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



More information about the aerogear-dev mailing list