I really hate people that don't document well their 'inventions'.

Let's take for example kotlinx.serialization library. It's a self-obvious fact that there are at least two things that will make anyone suffer: generics and polymorphism. So, they must be on the front page. Solved. With a recipe. Ready to use.

And what do we have? One mention somewhere in docs and an amazing test that 'explains' 'everything':

https://github.com/Kotlin/...

'What we got here is a failure to communicate.' (c)