There's also the problem that so much documentation is just straight auto-generated javadocs or xmldocs, with nothing beyond what you'd get looking at the method signatures.

MSDN is better than most, but there's still a ton in there in places that has no examples or usage information, no indication of what valid inputs are, no indication of any other external state that could derp things up.