Comments are Failures in Coding

Comments are Failures in Coding

“The proper use of comments is to compensate for our failure to express ourselves in code.” — Robert C. Martin, Clean Code

Every time you express yourself in code, you should pat yourself on the back.

Every time you write a comment, you should grimace and feel the failure of your ability of expression.

Find a way to express your intent in the code, directly. The only truly good comment, is the comment you found a way not to write.

Truth can only be found in one place — the code.

links