Excellent Tips for Code Comments

Commenting on how a piece of code works is a workaround for proper refactor and a sign of missing unit tests.

It's insightful to read John Fuex comparing code comments with signs/messages on everyday objects. You know something is wrong when you read this on an object: "For drinking liquids". Read his 5 best practices for commenting your code.