@lyncodev I've set up Jtwig with a proof-of-concept site using Orchid to generate documentation for tags and functions here. Orchid replaces Javadoc and is integrated with the standard Gradle build (
gradle assemble, you'll need to clean in-between builds currently). You can then view the site by starting any local HTTP server in
Internally, it uses the Javadoc tool's APIs to parse Javadoc comments and detect methods/fields/etc. just as you'd expect, but it then passes that data to Jtwig to render into the final output pages, which is a great way to demonstrate real-world usage of Jtwig. The theme is still pretty rough, and while it's still early in development now, the Orchid API is getting closer to being finished and there are several plugins we can add in if we want, such as static pages or a wiki (I've included the Wiki plugin in the Jtwig docs also).
In particular, I've set up one function,
batch, with an example for how we could begin to embed documentation directly in the source code for this. You can see the comments embedded in
org.jtwig.functions.impl.list.BatchFunction and how they relate to the page generated at
/functions/list/Batch. We can do similar things for tags, expressions, or anything else.
Anyway, go ahead and check it all out and see if this is a tool you'd like to use for future Jtwig documentation. I'll be here if you have questions or want to discuss this further, or you can email me directly at email@example.com.