I made some changes after opening, you should squash the commits in the UI and I'd probably include the "fixes #" in that message

Thanks @xenoterracide!
I see now the problem. The issue imo is more that we forgot to update the README once we migrated docs to the generate site with Antora. The docs there are correct while readme only contains Java 11 https://docs.asciidoctor.org/asciidoclet/latest/usage/.

I'd rather remove duplication than add to it, we could remove Usage and Additional features from the README and simply link to the antora docs in the introduction.

yeah, fair, I don't know where that code lives (haven't looked), and we still need a kotlin DSL example. It can be quite different... and is now the default when you generate a gradle project. Yay that kotlin.dcl is coming so eventually you'll need a 3rd format too... that bridge isn't really ready to cross though.

I don't know if that source has a way that allows you to select the language shown like gradle docs and some spring docs have, I'm guessing no.

should I update this PR? and and/or send a new one to those docs?

yeah, fair, I don't know where that code lives

Totally my mistake for not linking. It's a bit nested in docs dir, here it is https://github.com/asciidoctor/asciidoclet/blob/main/docs/modules/ROOT/pages/usage.adoc.

we still need a kotlin DSL example

I agree, it can be added next to the Gradle Groovy config for now. We could add "tabs" to the docs, but that needs to be done upstream in the docs aggregator repo. It's not something we can do autonomously now.

should I update this PR? and and/or send a new one to those docs?

Updating this is fine, I can take take of the squash from UI also.

thanks!