I am new to Kotlin and exploring among other things the KtDoc / Dokka generated documentation.
I see that there is no equivalent to the JavaDoc
@inheritDoc in Kotlin (ie. for inherited methods).
On a forum somewhere I saw a comment (don’t know if it was from a contributor or not) that the inheritDoc statement on many methods is superfluous and adds unnecessary lines - and if an inherited method doesn’t provide its own documentation, the documentation comes from the parent method.
While I sort of get that what I really don’t like is the mish-mash of documented and undocumented code.
I am always harping on my colleagues to document their code and the
@inheritDoc indicates at least that there is some documentation available and that the code author has at least put some thought into it.
Any chance of getting an equivalent in Kotlin?