JBatch: gradle and asciidoctor batch documentation

Generally most of the documentation of a project is manual but when you can automate some part why not doing it. When we speak about JBatch documentation we can automate two main parts by checking the sources:

TomEE Reference card: thanks Asciidoctor

Reference cards are “page(s)” listing in a single place key points and things to know of a product/language/…

To create them you can use the technology you want and i think a lot of them were created using Word, LaTeX etc…

However today generating it in HTML is a kind of must have since it is the easier way to share it but having it in PDF is still important since a RefCard should be available in offline mode too (to keep the original spirit).

Being able to split the content from the layout is a key point of languages like LaTeX, Markdown, Docbook…It is important for a reference card to be able to generate them in multiple formats.

I wanted to start to think to a reference card for TomEE and wondered what would be a good choice.