ganutenator
Lifetime Supporting Member
Excellent post.Both verboseness and terseness can obfuscate; it's quite the tightrope act.
In the Linux kernel coding style guide, there is an interesting statement about comments, but which speaks volumes about the code itself:
One goal of that style guide is code maintenance on a collaborative project; that has some parallels with the integrator/customer relationship (or even the [me now]/[me six months from now] relationship ).