On 09 Mar 2015, at 14:33, Erik Jan de Wit <edewit(a)redhat.com&gt; 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(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev

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(a)gmail.com&gt; To: "AeroGear Developer Mailing List" <aerogear-dev(a)lists.jboss.org&gt; 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(a)redhat.com&gt; 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(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/aerogear-dev _______________________________________________ aerogear-dev mailing list aerogear-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev _______________________________________________ aerogear-dev mailing list aerogear-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev

>Phone:404 941 4698 >Java is my crack.

>> Having said that, I like markdown better, but again, I am not an user :) > I think we were supposed to be migrating TO asciidoc. > Right now we need both, if there was a migration then it was never completely finished. So we should either rollback or finish it. > 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. Seems to me these reasons no longer apply

>> >> >> ----- Original Message ----- >> From: "Corinne Krych" <corinnekrych(a)gmail.com&gt; >> To: "AeroGear Developer Mailing List" <aerogear-dev(a)lists.jboss.org&gt; >> 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(a)redhat.com&gt; 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(a)lists.jboss.org >>> https://lists.jboss.org/mailman/listinfo/aerogear-dev >> _______________________________________________ >> aerogear-dev mailing list >> aerogear-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/aerogear-dev >> >> _______________________________________________ >> aerogear-dev mailing list >> aerogear-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/aerogear-dev > > -- > Summers Pittman >>> Phone:404 941 4698 >>> Java is my crack. > _______________________________________________ > aerogear-dev mailing list > aerogear-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/aerogear-dev _______________________________________________ aerogear-dev mailing list aerogear-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev

>Phone:404 941 4698 >Java is my crack.

We are including asciidoc texts into other asciidoc. I don't know if markdown supports that. ----- Original Message ----- From: "Summers Pittman" <supittma(a)redhat.com&gt; To: "AeroGear Developer Mailing List" <aerogear-dev(a)lists.jboss.org&gt; Sent: Monday, March 9, 2015 1:01:40 PM Subject: Re: [aerogear-dev] asciidoc vs markdown On 03/09/2015 11:58 AM, Erik Jan de Wit wrote: >>> Having said that, I like markdown better, but again, I am not an user :) >> I think we were supposed to be migrating TO asciidoc. >> > Right now we need both, if there was a migration then it was never completely finished. So we should either rollback or finish it. > >> 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. > Seems to me these reasons no longer apply If we can confirm that we don't need whatever exports I am thinking of I am +1 for moving back to markdown. > >>> >>> >>> ----- Original Message ----- >>> From: "Corinne Krych" <corinnekrych(a)gmail.com&gt; >>> To: "AeroGear Developer Mailing List" <aerogear-dev(a)lists.jboss.org&gt; >>> 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(a)redhat.com&gt; 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(a)lists.jboss.org >>>> https://lists.jboss.org/mailman/listinfo/aerogear-dev >>> _______________________________________________ >>> aerogear-dev mailing list >>> aerogear-dev(a)lists.jboss.org >>> https://lists.jboss.org/mailman/listinfo/aerogear-dev >>> >>> _______________________________________________ >>> aerogear-dev mailing list >>> aerogear-dev(a)lists.jboss.org >>> https://lists.jboss.org/mailman/listinfo/aerogear-dev >> >> -- >> Summers Pittman >>>> Phone:404 941 4698 >>>> Java is my crack. >> _______________________________________________ >> aerogear-dev mailing list >> aerogear-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/aerogear-dev > > _______________________________________________ > aerogear-dev mailing list > aerogear-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/aerogear-dev -- Summers Pittman >>Phone:404 941 4698 >>Java is my crack. _______________________________________________ aerogear-dev mailing list aerogear-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev _______________________________________________ aerogear-dev mailing list aerogear-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev