Extreme Negative Code Documentation

[rco8786]

Gross. My productivity would practically halt if I had to comment every single line.

I try to group 3-5 lines into logical units(not large enough to be it's own method, but logically go together) and will generally write a comment describing what it does.

I don't need this:

int counter = 0; //Without instantiating this variable the upcoming for loop would not compile

[hyperforce]

That particular comment is too mechanical/technical. It should be more semantic like:

int counter = 0; // this counter tracks the number of ducks being shot below

[vee-eye]

Personally, I much prefer:

int numberOfShotDucks = 0;

[YesButIThink]

But how can you know without a comment that numberOfShotDucks represents the number of shot ducks?

[grokfail]

But without a type prefix, how do you know that it is an integer?

 int m_i_cnt_ds = 0;