openapi: asciidoc output

[jknack]

It combines hand-written documentation written with Asciidoctor and auto-generated snippets produced from Jooby routes/open-api operations. This approach frees you from the limitations of the documentation produced by tools like Swagger.

It helps you to produce documentation that is accurate, concise, and well-structured. This documentation then allows your users to get the information they need with a minimum of fuss.

[agentgt]

@jknack also might want to checkout how javadoc supports markdown including an LTS version.

Recall that you can retrieve the javadoc from an annotation processor.