If I'm simply consuming a library, I find most real-world documentation to be pretty superfluous. A full working example is usually enough to understand how things fit together.
If I'm working on a library, design docs and commented code is nice though.
So even on those rare occasions when they do actually document something, the documentation tends to be pretty bare-bones and not very readable.
Good technical writers are worth their weight in gold.