“Don't belabor the obvious. Comment functions and global data.”

2011-09-13

Don't belabor the obvious. Comment functions and global data. Don't comment bad code, rewrite it. Don't contradict the code. Clarify, don't confuse.

Brian W. Kernighan, Rob Pike. The practice of programming.

@ google-books or @ bookfi