A modern programming language that makes developers happier.

kotlinlang

:rocket: *<https://github.com/Kotlin/dokka/releases/tag/v2.1.0|Dokka 2.1.0> release is out!* :rocket:
This version focuses on stabilizing experimental features, supporting new Kotlin language features, and improving the user experience. Key highlights include:
• Dokka Gradle Plugin v2 is now *enabled by default!*
• K2 Analysis is *enabled by default!*
• Support for *Context parameters* and *Nested typealiases*
• HTML format refinement: better *accessibility* and consistency across all components
• Multiple *performance* and compatibility improvements
We would really appreciate your *feedback*! :kodee-loving:

Dokka :heart: is finally coming to TestBalloon :testballoon:!

I'll try to document my impressions as a first-time Dokka user on a multi-module project:
• The <https://kotlinlang.org/docs/dokka-gradle.html|docs> have that v2 notice at the top, but then seem to be based on v1. Could this be explicitly stated?
• Even better, could there be a full v2 doc instead of having to pick sections from the migration docs?
• Most Dokka Gradle tasks are grouped under "other". For a better DX, could all user-facing tasks like `dokkaGeneratePublicationHtml` be grouped under "dokka"?
• In "<https://kotlinlang.org/docs/dokka-introduction.html|Tools > Dokka&gt;", it seems that when starting with v2, I have to ignore everything but the v2 sections in "<https://kotlinlang.org/docs/dokka-migration.html|Migrate to Dokka Gradle plugin v2>". Is that correct?

Another observation:
• <https://github.com/Kotlin/dokka/blob/3cc0b61498877f8e9025c1260f967f7e4236b301/examples/gradle-v2/versioning-multimodule-example/gradle.properties#L6|examples/gradle-v2> still contains the now obsolete Gradle property enabling v2 mode
That's it from me so far. Hope this was helpful.

And it seems I have <https://github.com/Kotlin/dokka/issues/4314|found a> :bug:.

&gt; Even better, could there be a full v2 doc instead of having to pick sections from the migration docs?
Yes, sure! We are currently working on revamping the documentation based on v2!
&gt; Most Dokka Gradle tasks are grouped under "other". For a better DX, could all user-facing tasks like `dokkaGeneratePublicationHtml` be grouped under "dokka"?
AFAIK, this was a deliberate choice to hide some tasks, so that it will be much more obvious which task to run from the Gradle IDE window. Curious, why do you want to know the specific task name, `dokkaGeneratePublicationHtml,` and not just `dokkaGenerateHtml`?
&gt; In "<https://kotlinlang.org/docs/dokka-introduction.html|Tools > Dokka&gt;", it seems that when starting with v2, I have to ignore everything but the v2 sections in "<https://kotlinlang.org/docs/dokka-migration.html|Migrate to Dokka Gradle plugin v2>". Is that correct?
Yes, and after, we will update the documentation for v2, everything should be more obvious.

That's our bad, that we were not able to sync the whole documentation update for v2, and we will try to do better next time. At this point, <https://kotlinlang.org/docs/dokka-migration.html|Migrate to Dokka Gradle plugin v2> should contain all the information needed to setup Dokka with v2 plugin.

&gt; <https://github.com/Kotlin/dokka/blob/3cc0b61498877f8e9025c1260f967f7e4236b301/examples/gradle-v2/versioning-multimodule-example/gradle.properties#L6|examples/gradle-v2> still contains the now obsolete Gradle property enabling v2 mode
Thanks! Yeah, we should just remove them now, probably just an oversight after we flipped the default - <https://github.com/Kotlin/dokka/issues/4316>

&gt; Curious, why do you want to know the specific task name, `dokkaGeneratePublicationHtml,` and not just `dokkaGenerateHtml`?
The docs <https://kotlinlang.org/docs/dokka-migration.html#select-documentation-output-format|were pointing me to this task>. Now that I know more, I would no longer consider using `dokkaGeneratePublicationHtml`. So it was just my state of mind at this point of diving into Dokka. But I thought it would be useful to let you know and I can be a canary only once. :wink: