GitHub supports adoc; it's why I used it. https://github.com/apache/logging-log4j2/blob/master/BUILDING.adoc
On 5 January 2017 at 17:03, Gary Gregory <garydgreg...@gmail.com> wrote: > Hm, we will still have MD files for GitHub unless we have some tooling to > convert ADOC to MD. Thoughts? > > Gary > > On Thu, Jan 5, 2017 at 2:53 PM, Matt Sicker <boa...@gmail.com> wrote: > >> Where is .txt? I see .xml which is some sort of HTML extension format. >> >> I have more experience with markdown, but asciidoc seems to be more >> commonly used for actual documentation due to its feature set. I was >> thinking of suggesting that we convert our HTML manual into one of those >> formats. >> >> On 5 January 2017 at 13:24, Gary Gregory <garydgreg...@gmail.com> wrote: >> >>> AsciiDoc? Really? We need to settle on AsciiDoc or MD. Pick one. MD >>> seems to be quite popular these days. >>> >>> Gary >>> >>> On Thu, Jan 5, 2017 at 8:58 AM, Mikael Ståldal < >>> mikael.stal...@magine.com> wrote: >>> >>>> Since Matt's recent committ, we now have three different documentation >>>> formats: .txt, .md and .adoc >>>> >>>> Should we try to be more consistent? Maybe choose one of Markdown and >>>> AsciiDoc and convert to it? >>>> >>>> I am used to Markdown, but I can be convinced to use AsciiDoc instead >>>> if it has clear advantages. >>>> >>> >>> >>> >>> -- >>> E-Mail: garydgreg...@gmail.com | ggreg...@apache.org >>> Java Persistence with Hibernate, Second Edition >>> <https://www.amazon.com/gp/product/1617290459/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1617290459&linkCode=as2&tag=garygregory-20&linkId=cadb800f39946ec62ea2b1af9fe6a2b8> >>> >>> <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=1617290459> >>> JUnit in Action, Second Edition >>> <https://www.amazon.com/gp/product/1935182021/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1935182021&linkCode=as2&tag=garygregory-20&linkId=31ecd1f6b6d1eaf8886ac902a24de418%22> >>> >>> <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=1935182021> >>> Spring Batch in Action >>> <https://www.amazon.com/gp/product/1935182951/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1935182951&linkCode=%7B%7BlinkCode%7D%7D&tag=garygregory-20&linkId=%7B%7Blink_id%7D%7D%22%3ESpring+Batch+in+Action> >>> <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=1935182951> >>> Blog: http://garygregory.wordpress.com >>> Home: http://garygregory.com/ >>> Tweet! http://twitter.com/GaryGregory >>> >> >> >> >> -- >> Matt Sicker <boa...@gmail.com> >> > > > > -- > E-Mail: garydgreg...@gmail.com | ggreg...@apache.org > Java Persistence with Hibernate, Second Edition > <https://www.amazon.com/gp/product/1617290459/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1617290459&linkCode=as2&tag=garygregory-20&linkId=cadb800f39946ec62ea2b1af9fe6a2b8> > > <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=1617290459> > JUnit in Action, Second Edition > <https://www.amazon.com/gp/product/1935182021/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1935182021&linkCode=as2&tag=garygregory-20&linkId=31ecd1f6b6d1eaf8886ac902a24de418%22> > > <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=1935182021> > Spring Batch in Action > <https://www.amazon.com/gp/product/1935182951/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1935182951&linkCode=%7B%7BlinkCode%7D%7D&tag=garygregory-20&linkId=%7B%7Blink_id%7D%7D%22%3ESpring+Batch+in+Action> > <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=1935182951> > Blog: http://garygregory.wordpress.com > Home: http://garygregory.com/ > Tweet! http://twitter.com/GaryGregory > -- Matt Sicker <boa...@gmail.com>
