Do not provide comments that do not add to the comprehensibiltiy of the code.
Design choices must be described briefly but clearly in your comments.
These two sentences seem to contradict each other, or is that last
word 'comments' not refering to code comments?
Does anyone decide to write minor design descisions in the code comments?