From TDN

Commenting

The good coding habits section needs an entry on comments. What kind of comments are helpful and what kind are only distractions. Ben mentioned literate programming in another section. This might be good to bring up with comments (i.e., assume a literate programmer and comment to explain what isn't obvious from the code). Consideration should be given to the fact that comments that are wrong (or out of date with the code) can be counter-productive. Code Complete chapter 19 would be a good place to start when writing this best practice.

--Cfagot 14:19, 10 Jul 2005 (CDT)