What do you feel about code commenting and how do you comment your code?
I feel we gave 2 goals : 1) The one who has written it should be able to understand it after 2 weeks, 2 months and 2 years later too. 2) Someone who has knowledge about the module should also be able to understand.
Benito Kestelman
I'm a big fan of commenting a lot so my teammates and I can easily understand our code without having to parse it - one of the most frustrating things when reading other people's code is lack of comments - but actually some of the best advice on comments I've heard is about writing fewer comments: