My favorite article of all time about code comments: http://antirez.com/news/124 http://antirez.com/news/124 I regularly recommend it to colleagues who make th

My favorite article of all time about code comments: http://antirez.com/news/124 http://antirez.com/news/124 I regularly recommend it to colleagues who make the bold claim that "No one needs comments. Good source code can and should document itself". The article covers pretty much all the types of comments and rules discussed in the OP and others not mentioned there.