[OT] Re: [Newbies] Smalltalk klass dokumentation ?
hannes.hirzel at gmail.com
Wed May 12 00:22:56 UTC 2010
Java was and still is a success no matter how you put it.
Coming up with class comments for Squeak is a hard job because it
involves a lot of design recovery.
Comments are supposed to generalise code details in a language which
is easy to understand.
The challenge is not talking about these things as they are pretty
obvious. Actually writing comments is a challenge. As soon as you
start digging into it you realise that there is _a lot_ to do. The
task is rather daunting.
On 5/11/10, Randal L. Schwartz <merlyn at stonehenge.com> wrote:
>>>>>> "Kommentaren" == Kommentaren <kommentaren at bredband.net> writes:
> Kommentaren> Documentation is important.
> Agreed. Which is why it's so easy to create class comments, and method
> comments, and browse/search those comments *while* you are using the
> We don't need dead trees or static docs. We want docs that are as alive
> as the code is.
> Kommentaren> Sun knows what they are doing.
> Hardly. Sun doesn't even exist anymore. How "knowing" is that?
> Randal L. Schwartz - Stonehenge Consulting Services, Inc. - +1 503 777 0095
> <merlyn at stonehenge.com> <URL:http://www.stonehenge.com/merlyn/>
> Smalltalk/Perl/Unix consulting, Technical writing, Comedy, etc. etc.
> See http://methodsandmessages.vox.com/ for Smalltalk and Seaside discussion
> Beginners mailing list
> Beginners at lists.squeakfoundation.org
More information about the Beginners