It may seem odd to have a command in C++ (or any other programming language)
that’s specifically ignored by the computer. However, all computer languages
have some version of the comment. It’s critical that the programmer
explain what was going through her mind when she wrote the code. A programmer’s
thoughts may not be obvious to the next colleague who picks up
her program and tries to use it or modify it. In fact, the programmer herself
may forget what her program meant if she looks at it months after writing the
original code and has left no clue.
Name:
Anonymous2008-02-06 8:12
Expert Programmers don't need comments, the code is obvious.
Name:
Anonymous2008-02-06 8:17
explain what was going through her mind when she wrote the code. A programmer’s
what was going through her mind when she wrote the code
through her mind when she wrote the
mind when she wrote
she
Comments are overrated.
Comment only the completely necessary.
Comments are not *code documentation*.
I don't mind having to deal with 10.000 lines with 0 comments if there's a complete document that documents (duh) the behavior of the code.
Likewise, 10.000 fully commented lines with 0 documentation would really piss me off.
Name:
Anonymous2008-02-06 9:16
I put my comments in SPOILER TAGS
Name:
Anonymous2008-02-06 10:26
>>8 Comments are not *code documentation*. I don't mind having to deal with 10.000 lines with 0 comments if there's a complete document that documents (duh) the behavior of the code.
Separating documentation from code is unnatural and cumbersome.