A modern programming language that makes developers happier.

kotlinlang

image (11).png

Screen Shot 2021-10-13 at 09.57.58.png

Hey folks! A little survey  :kotlinnew:

*What UI do u like more* for symbols that have the same declaration and docs in multiplatform projects?
1. :hamburger: merged (if tabs have the same content)
2. :pizza: divided (even tabs have the same content)
3. :thinking_face: my variant (in comments)
Please share pros and cons of solution you've chosen. Thanks!

I like merged. Coz it tels me more about how the expect was implemented underneath

Wouldn't there be a corresponding `expect` declaration to put the common Kdoc? This is where I would look in the first place

I don't mind the divided KDoc for actual definitions as it matches the source code. Without context, I wouldn't have guessed the merged tabs were about same documentation

second one, I am not designer but the first one with multiple little lines looks really strange.

I can't see 3, image is missing

I think 3. was meant as "your variant" :slightly_smiling_face:

underline being so thin looks really good, but it is difficult to see the color to avoid having to read the source set, maybe 1px or 2px improve UX, because in this case I prefer better UX than pretty UI

It would be nice to show platforms where they aren't present as struck through or something, if those platforms are used elsewhere in the module.

I guess that another option would be to use multiple bubbles just like current documentation of stdlib and in case of signatures / descriptions being different just render multiple of those. This will increase the length of the page but will make it easier to navigate via cmd+f or just scrolling (without a need to click).

Version with grouped sourcesets looks nice but i fear that this won’t be obvious for an outsider (without the circles and verbal description it is not clear why this padding is applied), therefore can be treated as a bug

Thanks to all! Let's keep tabs separate to decrease cognitive load

Instead of bubbles which add visual clutter, could you use additional spacing between ungrouped tabs?