Hey folks!
Thanks to everyone who updated to Dokka 2.0.0 and tried DGPv2! We really appreciate it and it will help as a lot with stabilization of it!
But today I wanted to ask for a feedback about another big chunk of rework we were working recently and which is available in Dokka 2.0.0:
K2 analysis!
To remind a bit it's importance: future language features (like context parameters) will be supported
only in K2 analysis!
It'c crucial for us to understand how stable it is and how much work still need to be done. And while we constantly validating it on both internal (kotlinx.*) and some external projects, we can't cover all projects...
It would be nice if you could try it in your projects and report any issues/inconsistencies!
K2 analysis has some known limitations (mentioned in
release notes) and
known issues/inconsistencies - but most of them are not that scary 🙂
To opt in to Dokka's K2 analysis, add the following flag to your project's
gradle.properties
file:
org.jetbrains.dokka.experimental.tryK2=true
How to test that everything is fine?
1. just build documentation - should work in almost all cases 🙃
2. check several pages of generated API reference - there could be minor differences comparing to K1 analysis - still it would be nice to report them if they are not mentioned in
known issues/inconsistencies or potential differences (mentioned in
release notes)
It's also possible to compare generated HTML's side-by-side, but unfortunately there could be a lot of noise there 😞
Anyway, we would really appreciate your
feedback!
kodee loving
P.S. don't be afraid to ask any questions regarding K2 here in thread or in channel!