Hey all. Don't you think it'd make sense to add pl...

# dokka

[Big Chungus]

Hey all. Don't you think it'd make sense to add platfrom-specific bubbles on common code declarations to better indicate for which platforms those are available?

[Big Chungus]

i.e. serialization-core is mainly available on all platforms, except for few JVM specific bits. I think it'd be much clearer if this page would explicitly list all targets for all packages https://kotlin.github.io/kotlinx.serialization/kotlinx-serialization-core/kotlinx-serialization-core/index.html

[mike.holler]

YES. I figured this is what Jetbrains was using to generate those tips in stdlib. Is it not in Dokka proper yet?

[mike.holler]

I was actually planning on trying to generate multiplatform documentation today for the first time and was expecting to see this working.

[mike.holler]

@Big Chungus 1.4.10 has this, I just generated this:

[mike.holler]

Screenshot from 2020-10-09 14-34-55.png

[Big Chungus]

That's not what I meant

[Big Chungus]

I was suggesting that in the case you've just posted, all Base64* types should have not only "common" bubble, but also "js" and "jvm", because there are compilations of those platforms for each

[mike.holler]

AH! Yes, like in the official docs.

[Big Chungus]

Essentially explicit listing instead of lowest common denominator

[mike.holler]

There must be a way to configure Dokka to do that...

[Big Chungus]

Because from the snippet above, I have no clear view if that Type is available for Native for example

[mike.holler]

Yeah it's a good point.

[Marcin Aman]

I have some concerns about this form of presentation, mainly because bigger libraries like coroutines have a lot of targets and displaying them inline is nearly impossible (take a look at this page).
I was thinking about a solution when by default sourcesets will be merged by kind (all natives, commons, JVMS etc) and displayed as a small dot (like in the docs right now). Now comes a tricky part when we need to expand this information. I don't have any idea how to it better than just expand all of them. I'll ask our designer 😄

I've created an issue to tract this thread: https://github.com/Kotlin/dokka/issues/1549