Now, this is a great counter-rant, replying to one of my more popular articles:
https://blog.jooq.org/the-golden-rules-of-code-documentation/
The counter-rant is given here: http://javax0.wordpress.com/2013/04/07/to-comment-or-not-to-comment-that-is-the-question
The writer went through the trouble of actually implementing my fictional (but not unrealistic) example, which he’s publicly displaying on GitHub:
https://github.com/verhas/commentOrNotToComment (my fork, if the former was deleted)
The code still doesn’t communicate “why” it does things, it only communicates “what” it does. But I still like this reaction :-)