Avatar ·

Cómo usar @link y @code en KDoc (Kotlin) para documentar correctamente el código

¡Hola a todos! Recientemente comencé a aprender Kotlin y estoy tratando de documentar mis funciones con KDoc. Leí que se pueden usar las etiquetas `@link` y `@code`, pero no logro hacer que funcionen correctamente. Aquí hay un ejemplo de mi función: ```kotlin /** * Calcula la suma de dos números. * Usa @link Calculator para los cálculos. * @param a primer número de tipo @code Int. * @param b segundo número de tipo @code Int. * @return resultado de tipo @code Int. */ fun add(a: Int, b: Int): Int { return a + b } ``` El problema es que en la documentación generada (por ejemplo, en Dokka) veo solo el texto `@link Calculator` y `@code Int`, no enlaces formateados ni texto monoespaciado. Esperaba que `@link` creara un enlace clicable a la clase `Calculator`, y que `@code` resaltara `Int` como código. Probé diferentes variantes: escribí `{@link Calculator}`, `[Calculator]`, pero nada funciona. En la documentación oficial de KDoc dice que se admiten las etiquetas `@link` y `@code`.