Update dependency org.jetbrains.dokka:dokka-maven-plugin to v2

[renovate]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
org.jetbrains.dokka:dokka-maven-plugin	1.9.20 -> 2.0.0

---

Release Notes

Kotlin/dokka (org.jetbrains.dokka:dokka-maven-plugin)

v2.0.0: 2.0.0

Compare Source

Dokka 2.0.0 focuses on simplifying configuration and preparing for support of future Kotlin language features. Key highlights include:

• Dokka Gradle Plugin v2: revamped Gradle plugin based on Dokkatoo.
• Experimental K2 Analysis: support for K2 compiler frontend.
• HTML Improvements: better accessibility and easier customization.

More details about each of the changes below. See Dokka 2.0.0 milestone for the list of all changes.

Dokka's Gradle plugin v2 based on Dokkatoo

Please check the migration guide for the update procedure and give feedback!

Dokka 2.0.0 introduces significant improvements to Dokka Gradle plugin, aligning more closely with Gradle best practices:

• Adopts Gradle types, which leads to better performance.
• Uses an intuitive top-level DSL configuration instead of a low-level task-based setup, which simplifies the build scripts and their readability.
• Takes a more declarative approach to documentation aggregation, which makes multi-project documentation easier to manage.
• Uses a type-safe plugin configuration, which improves the reliability and maintainability of your build scripts.
• Fully supports Gradle configuration cache and build cache, which improves performance and simplifies build work.

Changes from Dokka 2.0.0-Beta

• Forward Dokka Generator messages to Gradle logger (https://github.com/Kotlin/dokka/pull/3833)
• Add deprecated property to help migrate from JSON Dokka plugin configuration (https://github.com/Kotlin/dokka/pull/3877)
• Rename dokkaPublicationDirectory to basePublicationsDirectory (https://github.com/Kotlin/dokka/pull/3876)
• Rename dokkaModuleDirectory, and mark as internal (https://github.com/Kotlin/dokka/pull/3880)
• Update and add KDoc for DGPv2 (https://github.com/Kotlin/dokka/pull/3842)
• Remove DokkaPluginParametersBuilder (https://github.com/Kotlin/dokka/pull/3872)
• Increase default max heap of Worker to 2G (https://github.com/Kotlin/dokka/pull/3913)
• Remove the dependency of dokkaGenerate on dokkaGenerateModule* (https://github.com/Kotlin/dokka/pull/3920)
• KT-71784 Fix classpath for KMP shared source sets (https://github.com/Kotlin/dokka/pull/3942)
• Fix DGP/KMP integration, so Dokka can 'see' code from shared source sets in target source sets (https://github.com/Kotlin/dokka/pull/3814)

Dokka's K2 analysis

Dokka 2.0.0 introduces K2 analysis, which is currently in an experimental stage. Dokka's K2 analysis leverages Kotlin's K2 compiler frontend for analysing code and uses the same shared Analysis API, which is used in IntelliJ IDEA’s K2 mode. The output with K2 analysis should mostly match that of K1 analysis, but there may be minor differences. We are actively working towards stabilizing K2 analysis and are planning to enable K2 analysis by default in future.

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

Known limitations:

• Intersecting source roots (#​3701) and intersecting sample roots (#​3373) may cause issues.
• Kotlin/JS libraries compiled with the legacy Kotlin/JS compiler are not supported (#​3751).

We would greatly value your feedback if you encounter any of these limitations.

Potential differences between the outputs of K1 and K2:

While the output of K2 analysis aims to align with K1, there are some differences to be aware of:

• Java synthetic properties: rendering may vary (details).
• KDoc links: resolution and rendering differences (details).
• Inconsistent documentable rendering order (#​3590).
• Enum entries: anonymous and overridden methods are no longer rendered (#​3129).
• Other differences may arise due to variations in type inference between K1 and K2.

HTML format

Dokka 2.0.0 introduces some changes to HTML output. We updated the structure of some elements and classes, particularly in the navigation and sidebar, to improve accessibility and simplify maintenance. These changes only affect you if you previously customized Dokka styles.

• We removed redundant wrappers like navigation--inner and navigation-title.
• We reworked blocks such as versions-dropdown to make them more accessible.
• We renamed classes like navigation-controls--homepage to improve consistency. For example, it’s now called navigation-controls--btn_homepage.

For more information, see the pull request.

The easiest way to update your current templates is to adjust the new templates to your needs.

Bugfixes

• Fix merging expect-actual declarations (https://github.com/Kotlin/dokka/pull/3875)

Other changes

• Update the external link URL for stdlib (https://github.com/Kotlin/dokka/pull/3938)

Feedback

We would appreciate your feedback!

• Please report any feedback or problems https://kotl.in/dokka-issues
• Chat with the community visit #dokka in https://kotlinlang.slack.com/ (To sign up visit https://kotl.in/slack)

Full Changelog: Kotlin/dokka@v1.9.20...v2.0.0

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.

[codacy-production]

Coverage summary from Codacy

See diff coverage on Codacy

Coverage variation	Diff coverage
✅ +0.00% (target: -1.00%)	✅ ∅

Coverage variation details

	Coverable lines	Covered lines	Coverage
Common ancestor commit (9ef36b8)	176	142	80.68%
Head commit (52f8689)	176 (+0)	142 (+0)	80.68% (+0.00%)

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details

	Coverable lines	Covered lines	Diff coverage
Pull request (#47)	0	0	∅ (not applicable)

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

See your quality gate settings    Change summary preferences

_{Codacy stopped sending the deprecated coverage status on June 5th, 2024. Learn more}

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 75.56%. Comparing base (9ef36b8) to head (52f8689).
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #47   +/-   ##
=======================================
  Coverage   75.56%   75.56%           
=======================================
  Files          14       14           
  Lines         176      176           
  Branches       15       15           
=======================================
  Hits          133      133           
  Misses         34       34           
  Partials        9        9           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[renovate]

Edited/Blocked Notification

Renovate will not automatically rebase this PR, because it does not recognize the last commit author and assumes somebody else may have edited the PR.

You can manually request rebase by checking the rebase/retry box above.

⚠️ Warning: custom changes will be lost.