Is there a way to configure dokka to automatically put doc comments from `expect` functions in `comm...

# dokka

[mike.holler]

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

[Ignat Beresnev]

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

[Ignat Beresnev]

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

[mike.holler]

That would be great, thank you @Ignat Beresnev -- I don't know about a capacity for inheritance in the kdoc spec, but if you do I'm interested in learning 🙂

[mike.holler]

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

[mike.holler]

@Ignat Beresnev 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.

[Ignat Beresnev]

were you able to create this issue?

not yet, sorry 😞 getting tied up with relocation

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

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 🙂 We have a special kdoc-spec tag for such issues to be discussed within the Kotlin team in the near fear

[mike.holler]

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

[Joffrey]

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