News for hackers. Stuff that matters.
Re:I've never seen a language's style guide recommend avoidi... by spacemanmatt on Wednesday July 23, 2014 @06:33AM (#8073614)
I want comments to give me a short-cut to reading a long block of code, and I want comments to give me a basic method of analyzing the code for correctness. The thumb-rule of documenting "why" rather than "how" seems to apply.

I shouldn't have to read code in detail to understand it, unless it is broken and I am fixing it. Comments should inform me on the broad strokes of the code.

There are no comments on this comment yet.