(📚) document how `__pretty__` works

[KotlinIsland]

i want to use it, but it's quite difficult to figure out it's semantics without documentation