A modern programming language that makes developers happier.

kotlinlang

Hi! I'm wondering if there's any source or reference for the <https://kotlinlang.org/docs/coding-conventions.html#documentation-comments|Documentation comments convention>:
```Generally, avoid using @param and @return tags```
But *why?* Those tags  seems useful for converting comments info other formats in my view

Probably because converting to a different format is the 1% case while the 99% case is developers reading the standard docs. And as the example below shows, it's a lot better to read and a lot less redundant without those separate tags.

But it's only a recommendation. The tags are there, use them if you like them. :man-shrugging: