I think they serve different purposes. For example Python pandas has excellent documentation, and usually that's enough if you need to know how to use a function.

However, for many programmers the difficulty is to break down real problems into functions, and docs however good they are, won't help much.