Class comments!?

goran.krampe at bluefish.se goran.krampe at bluefish.se
Mon Oct 18 19:00:42 UTC 2004


Thank you, thank you, thank you. I thought I was going insane for a
while. :)

regards, Göran

"Richard A. O'Keefe" <ok at cs.otago.ac.nz> wrote:
> 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