Avatar ·

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.