Originally Posted by grumpy

I generally seek to write code in a manner that avoids unnecessary comments. For example, picking names of variables/functions/types well can mean the code itself is its own documentation; comments are then less necessary.