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`.