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
|