A modern programming language that makes developers happier.

kotlinlang

*Dokka 1.9.0* has finally been released :tada:

The team is working hard on migrating Dokka's internals to the K2 compiler and on addressing long-standing technical debt and stability issues, but it doesn't mean this release is without noticeable improvements!

• Type aliases have their own pages now, with improved presentation!
• Support for the 1.9.0 language feature <https://youtrack.jetbrains.com/issue/KT-48872|Enum.entries>
• The HTML format is now mobile-friendly and very responsive
• Beautiful JetBrains Sans is now used as the primary text font
<https://github.com/Kotlin/dokka/releases/tag/v1.9.0|Full changelog on GitHub>

---

We're aware that a significant number of KMP projects using Gradle 8 are experiencing build failures related to the resolution of native/platform dependencies, so Dokka 1.9.0 includes some workarounds, see <https://github.com/Kotlin/dokka/issues/3153|#3153> for more details. We aim to provide a well-tested solution in the next release.

Lastly, to lay a solid foundation for the future, we unfortunately had to introduce some *breaking changes*, but they should only affect a small number of users. If you customize Dokka's HTML output (via css styles / templates), use the CLI runner or author a non-trivial Dokka plugin, you might be affected. Please, see the last section of the <https://github.com/Kotlin/dokka/releases/tag/v1.9.0|release notes> for more details.

image.png

congrats! It's good to see lots of under-the-hood changes to make Dokka better.

Small note: The release is described as a 'Beta' on GitHub <https://github.com/Kotlin/dokka/> - is this a Beta release?

Screenshot_20230902-130403.png

I'm surprised that you, of all people, have only noticed it now Adam, given how many release notes you've been mentioned in :sweat_smile: All of the previous ones are also marked as "Beta", and between 1.4 and 1.6 they were marked as "Alpha" :) 

It's meant to describe the status of the tool itself (as in alpha/beta/stable), not of this specific release (as in beta/rc/release). You can click on the "Beta" badge in the readme to read more about it

We have the <https://github.com/Kotlin/dokka/milestone/23|Stable milestone>, which has only two epic issues now (K2 and Gradle Plugin), and once it's complete - we'll likely name Dokka stable. But we want to make sure it is truly stable at that point, and I think everyone can agree that Dokka is not there just yet :pensive:

ahh okay, I see what you mean, the project itself is still in beta. 

I don't think other projects have this same convention? I think it's odd that the release is described as 'beta', but the version and git-tag don't have a -BETA suffix.

Yeah, I don't think they do.. 

I wanted to say that I put "Beta" in the release name for consistency with the previous releases dating back to 1.4, but then I thought that we could just edit the old releases to be consistent (i.e remove Beta and Alpha from the release names)

Let me discuss it with the team to see if they have any objections

Hi! I just migrated my main project to Dokka 1.9.0, which was broken because of the Gradle 8 issues, and everything seems to work!