[OT] Re: [Newbies] Smalltalk klass dokumentation ?

[Hannes Hirzel]

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.

--Hannes

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
> code.
>
> 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
> http://lists.squeakfoundation.org/mailman/listinfo/beginners
>