Kotlin / dokka

API documentation engine for Kotlin
https://kotl.in/dokka
Apache License 2.0
3.45k stars 412 forks source link

Support Java Markdown Doc Comments (JEP 467, JDK 23) #3934

Open odenix opened 4 days ago

odenix commented 4 days ago

Is your feature request related to a problem? Please describe I have a mixed Java/Kotlin project and use Dokka to generate its documentation. Recently I refactored all Javadoc to use Markdown Doc Comments (JEP 467, JDK 23). It's a big improvement, but Dokka doesn't recognize it.

Describe the solution you'd like I'd like Dokka to support Markdown Doc Comments (///) in addition to the regular Javadoc syntax (/** */).

Describe alternatives you've considered Generate Java documentation with javadoc, and Kotlin documentation with Dokka. This is my current workaround, but it’s not pretty, and not in the Dokka spirit.