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: Most of your code should be clear enough without comments. If you are commenting a lot because your code is hard to understand, this should be a red flag that you need to organize it better (e.g. by breaking it up into smaller functions). Make sure to keep comments up to date with the code. The only worse thing than no comments is comments that are wrong! (following rule 1 helps with this)