Comments by "" (@redtela) on "If Code Is Self-Documenting, Why Do Comments Exist?" video.

In my opinion, this is a false dichotomy. Uncle Bob got it right: comments are evil, and require maintenance of their own. Comments are valid, but only when you fail (for whatever reason - and there are many valid reasons) to write clean code. I recently went back to a project that was written months ago, and I needed to add a feature. There were no comments. I was rather pleasantly surprised that it didn't take long to do, because the code was readable. I recently told a friend that I had a productive day - and all I changed was one word, on one line. Again, in my opinion, the real benefit of comments, is in the commit message - rather than in the code itself.
1