A modern programming language that makes developers happier.

kotlinlang

Is there a way to configure dokka to automatically put doc comments from `expect` functions in `commonMain` on the `actual` functions for each runtime? When dokka generates docs, it generates an individual (e.g.,) function doc for each runtime (jvm, js, native, ...). The common one has documentation because it has doc comments, the concrete runtime ones do not have doc comments. I'd like them to be "inherited" from the `expect`

Hi! I think this question is related more to kdoc spec than to Dokka itself -- if the spec says it should be inherited, it will.

Unfortunately, for now there's no concrete answer, but we're been actually thinking about it and hopefully it will be resolved soon

I'll create an issue a bit later so that you can follow it for the updates

That would be great, thank you <@U02NK3U2Y65> -- I don't know about a capacity for inheritance in the kdoc spec, but if you do I'm interested in learning :slightly_smiling_face:

Surprised I got so many :heavy_plus_sign: ! Thank you all for the support!

<@U02NK3U2Y65> were you able to create this issue? If not I can go on and file it. Not sure the best place to file kdoc tickets though.

&gt; were you able to create this issue?
not yet, sorry :disappointed: getting tied up with relocation

&gt; If not I can go on and file it
If you can, that'd be great! I'll add more info in comments if needed

&gt; Not sure the best place to file kdoc tickets though
Unfortunately, that's about the only place where it won't get lost. There's no team responsible for kdoc format itself atm, so Dokka seems to be the closest party interested in it :slightly_smiling_face: We have a special `kdoc-spec` tag for such issues to be discussed within the Kotlin team in the near fear

Got it, so issue on Dokka GitHub with `kdoc-spec` tag

For reference: <https://github.com/Kotlin/dokka/issues/2493>