"A high number of comments might indicate that the code is well-documented and organized, and could be a sign of a helpful and disciplined development team."

Avatar

jpdv

12 months ago

I'm sorry to say that this comment from your software does not conform to the nowadays development paradigms.

It would be preferable if you provided metrics on dependencies and complexity.

Frankly, code comments is something that is hard to maintain and are seldom up to date, for sure, big teams do not use them in this coding days.

Best regards.


Avatar

mitchell

12 months ago

The statement is not definitive, so I don't see what is wrong with it. Care to suggest an alternative comment?


Avatar

Phil Booth

11 months ago

How about: "A high number of comments might indicate that the code is complex or badly structured, and could be a sign of a confused and undisciplined development team."

That is also not definitive and probably about as accurate as the current, broadly sweeping generalisation. :)


Avatar

Adam Kennedy

11 months ago

Frankly, code comments is something that is hard to maintain and are seldom up to date, for sure, big teams do not use them in this coding days.

Are you kidding me?