Como usar @link e @code no KDoc (Kotlin) para documentar código corretamente?
Olá a todos! Recentemente comecei a estudar Kotlin e estou tentando documentar minhas funções com KDoc. Li que é possível usar as tags `@link` e `@code`, mas não consigo fazê-las funcionar corretamente.
Aqui está um exemplo da minha função:
```kotlin
/**
* Calcula a soma de dois números.
* Usa @link Calculator para os cálculos.
* @param a primeiro número do tipo @code Int.
* @param b segundo número do tipo @code Int.
* @return resultado do tipo @code Int.
*/
fun add(a: Int, b: Int): Int {
return a + b
}
```
O problema é que na documentação gerada (por exemplo, no Dokka), vejo apenas o texto `@link Calculator` e `@code Int`, em vez de links formatados ou texto monoespaçado. Eu esperava que `@link` criasse um link clicável para a classe `Calculator`, e que `@code` destacasse `Int` como código.
Tentei diferentes variações: escrevi `{@link Calculator}`, `[Calculator]`, mas nada funcionou. Na documentação oficial do KDoc, está escrito que as tags `@link` e `@code` são suportadas.