That is a very good point. But it is not contradicting the main point of most people here. Of course there is good documentation and important documentation. It is just that most of the times your code does not need a big bloat of text around it.

And I would say that your point is a much better example than the one used in the blog post.