Kotlin KDoc: ¿Documentación?
He visto aquí , aquí y allá, references a KDoc, el equivalente de la utilidad JavaDoc para Kotlin.
Sin embargo, no puedo encontrar ninguna documentation sobre cómo usarlo, y mucho less cómo personalizarlo o integrarlo en Maven o Gradle.
- herramientas de documentation automática de kotlin
- Dokka usa nombres de class completamente calificados
- ¿Dónde / Cómo se agrega documentation para los packages de Kotlin?
- ¿Qué versión de Dokka va con qué versión de Kotlin?
- Dokka: omita la generación de javadoc para los packages pnetworkingeterminados de Android
Sé que el documento de la API de Kotlin se genera utilizando KDoc, ya que el origen de la página tiene el siguiente comentario en HTML: <!-- Generated by kdoc on Sun Jul 06 20:27:33 UTC 2014 -->
Entonces, ¿hay alguna documentation a la que pueda referirme sobre cómo usar KDoc?
- ¿Cuál es el nombre correcto para la documentation en línea de Kotlin?
- Suprima las quejas de Dokka sobre "No hay documentation para com.foo.Bar $ toString ()"?
- Cómo documentar un parámetro de constructor primario con Kotlin Dokka
- No se puede get dokka para generar documentos de kotlin en el proyecto gradle / android
- kotlin no resuelto enlace KDoc pero a IntelliJ no le gusta la import que lo arregla
- Copie los documentos de KDoc de un método a otro
- Dokka javadoc jar no funciona con Intellij IDE
- Genera kdoc y mira en el browser
Parece que Kdoc fue dejado de lado en favor de Dokka. https://github.com/Kotlin/dokka
Fuente: https://devnet.jetbrains.com/thread/458339;jsessionid=B2038D70DCC9004181B20D6D4EA2B2A3