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