Hi Keith, we´re currently migrating from DocBook to AsciiDoc and can really recommend it. It provides a great tool chain, which let´s us write documentation really fast. We also created a tutorial about AsciiDoc (http://www.vogella.com/tutorials/AsciiDoc/article.html) and the official documentation of AsciiDoc is great. It also has a strong and vibrant community and lots of companies are using it.
We´re also using https://wiki.eclipse.org/Mylyn/WikiText/AsciiDoc and recently also provided some nice enhancements to it. The project lead, David Green, of WikiText is really responsive. (Thanks for that ;-)) In order to build the documentation we use the asciidoctor Gradle plugin(https://github.com/asciidoctor/asciidoctor-gradle-plugin), but there´s also a plugin for Apache Maven. Best regards, Simon On Tue, Jul 12, 2016 at 10:14 PM, Jens v.P. <[email protected]> wrote: > Dear Keith, > > We are currently switching to Asciidoc (http://www.methods.co.nz/asciidoc/), > using Asciidoctor (http://asciidoctor.org/) for tooling. It is supported by > Mylyn’s WikiText (https://wiki.eclipse.org/Mylyn/WikiText/AsciiDoc), and we > already create Eclipse Help, HTML pages, and PDF from a single source. > > We are at the very beginning, and we have only migrated some user > documentation, see > https://github.com/NumberFour/n4js/tree/master/docs/eu.numberfour.n4js.doc. > In the long run, we want to port our Latex based specification to Asciidoc > and use that as the only format. For that, we are currently investigating > custom macros (both for AsciiDoc and Mylyn Wikitext). > > Regards, > Jens > > _______________________________________________ > incubation mailing list > [email protected] > To change your delivery options, retrieve your password, or unsubscribe from > this list, visit > https://dev.eclipse.org/mailman/listinfo/incubation > _______________________________________________ incubation mailing list [email protected] To change your delivery options, retrieve your password, or unsubscribe from this list, visit https://dev.eclipse.org/mailman/listinfo/incubation
