Class comments!?
Richard A. O'Keefe
ok at cs.otago.ac.nz
Mon Oct 18 05:17:38 UTC 2004
Bernhard Pieber <bernhard at pieber.com> wrote:
- Comments are a form of redundancy.
It seems to me that this is the heart of his argument.
I deny it. What I always tell me students is
"Comments should tell the reader what s/he needs to know
that ISN'T there in the code."
The topic of this thread is class comments, and they are by no means
redundant. When written by someone with even half a brain, they tell
me things I need to know that are NOT obvious from the code.
And that's why we need them.
More information about the Squeak-dev
mailing list
|