I've read some documention

and it's often so terribly written, like its written BY and TO someone who already knows everything about it, so its super vague and so basically useless.

a good example on documentation, IMO, is mozillas javascript documentation. that's great.

i really dont like microsofts C# documentation though. and there's probably worse ones out there.

(I will add, english isn't my primary language and the documentation is almost exclusively available in english)