[squeak-dev] Re: Winds of change
Andreas Wacknitz
A.Wacknitz at gmx.de
Sat Feb 7 23:48:13 UTC 2009
Aidan Gauland schrieb:
> Giuseppe Luigi Punzi <glpunzi <at> lordzealon.com> writes:
>> We have elections soon.
>>
>> I'ts time to think about the project. What we search? What new
>> developers search?
>
> For me, the biggest problem with Sqeuak at the moment is its lack of class and
> method comments (but not every method needs an overview comment). I would like
> to say to all developers of the uncommented system classes: "Will you please go
> back and comment, all the methods and classes you wrote, but failed to
> document!" And I know I'm not the only one who feels this way. Hold back on
> new features for just a minute, and give what we already have a quick polish.
> I've wasted many hours trying to puzzle out how to use complex yet undocumented
> methods (some weren't even documented on the Squeak Swiki). The basic
> collection classes, and the core system classes are well commented.
>
> -Aidan
>
> P.S No hard feelings, just some frustration. Sqeuak is a great development
> system, and seems to keep getting better.
>
>
I would say: all public classes and methods that are not obvious
(intention revealing) shall be documented. And there should be an
introduction or overview on package level.
Sigh, I am a dreamer...
Regards
Andreas
More information about the Squeak-dev
mailing list
|