I’m curious if there’s a convinient process to generate a DSL in a common way, so that a Gradle style DSL documentation results. How do you do this ATM?
The gradle project currently uses a very custom approach to generate the DSL documentation.
1. we extract meta-data from the Groovy and Java source files which make up the Gradle API
2. Then we generate docbook xml out of this (see http://www.docbook.org)
3. We generate html from the docbook content.
You can have a look the the docs subproject in the gradle codebase for more details. see https://github.com/gradle/gradle/tree/master/subprojects/docs
hope that helps. You might also want to take a look at http://asciidoctor.org for automating your documentation workflow.
Thanks a lot, I’ll check this during the next days. Cheers!