Discussion on: "Do not comment on your code, it should be self-documented". Well... I don't agree.

[Christopher Thomas]

Comments are useful to me when:

• You're telling someone why this is being done, in the general sense
• You're explaining an algorithm that isn't clear
• You're explaining a business decision / business logic
• You're leaving a TODO for yourself to implement later or fix or come back to finish