in reply to Re: Documenting Methods/Subs
in thread Documenting Methods/Subs

Just because someone _thinks_ that their code is self commenting doesn't mean that they are correct.

Just because somebody _thinks_ that their comment explains the code doesn't mean they are correct :-)

Bad comments are just as evil as bad code. In fact they are worse, since you then have the problem of what is correct - the code or the comment.

I'm not anti-comments - but they do have problems of their own which are often unacknowledged. Over the years I have found self-documenting code (tests, assertions, etc.) to be of more use in many, if not most, instances.

I would also ask the coder why they didn't add comments - but I would see if they had sensible answers before consigning the resume to the bottom of the pile :-)