It's an art.... (Score 1)

Commenting code, like coding itself, is as much an art as a science. Not a lot of people do either well, and finding someone who does both well is rarer still. It isn't an easy task to quantify objectively what makes for "good" comments.

In the end, you want something clear and concise. But describing how to get there is tough.