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 <mer...@stonehenge.com> wrote: >>>>>> "Kommentaren" == Kommentaren <kommenta...@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 > <mer...@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@lists.squeakfoundation.org > http://lists.squeakfoundation.org/mailman/listinfo/beginners > _______________________________________________ Beginners mailing list Beginners@lists.squeakfoundation.org http://lists.squeakfoundation.org/mailman/listinfo/beginners
