[Seaside] Why seaside really sucks! COMMMMMMMENTS are MISSING

[Brad Fuller]

Amen, brother.

stephane ducasse wrote:
> This is not easy for me to say that because I appreciate the work of 
> Avi, Lukas and Philippe.
> But I'm sorry to say that but seaside sucks! Not because of the code 
> or the concepts.
> But because there is really not enough comments. Really! It is really 
> difficult to understand a simple
> method is doing and if it makes sense to specialize it.
>
> This is TERRIBLE since I think that I'm a good programmer but seaside 
> code prevents me to
> be fully efficient. I have to guess try and error and guess again. I 
> have to ask stupid questions to the mailing-list
> while I would prefer to use it for  interesting questions. I think 
> that seaside goes even against the philosophy of
> Smalltalk (a system that someone alone can understand) because this 
> total lacks of
> comments is TRAPPING me. I cannot use my skills full speed. Thanks 
> what a great feeling.
> pleaseeeeeee do not tell me to read the code or to use senders! This 
> is really the worse answer I can get.
> I always hated this kind of answer on smalltalk forums.
>
> (Please do not ask me what I'm doing to improve the situation because 
> people knows what I did
> for seaside and Smalltalk already.)
>
> I think that as a community we should do something especially since we 
> have monticello
> and comments could be easily merged.
>
> I pushed a lot seaside and I'm trying to push it again further but 
> come on we should WAKE UP!
> I would really like that people with knowledge helps improving the 
> situation.
>
> So if you think that seaside is cool and it is worth more, spend 30 
> min of your precious time and
> add comments, help lukas and the other to make Seaside really a 
> habitable piece of code.
>
> Comments are for people that do not know or remember. So if you really 
> want to make the community
> grow you know what you should do. But may be it is better that seaside 
> stays a cool program for a nice and
> private club after all.
>
> Stef
>
> PS: I should say that filelibrary is a good start at documenting a 
> functionality. May be adding method comments
> would help there too.
>
> _______________________________________________
> Seaside mailing list
> Seaside at lists.squeakfoundation.org
> http://lists.squeakfoundation.org/cgi-bin/mailman/listinfo/seaside
>


-- 
brad fuller
 http://www.Sonaural.com/
 +1 (408) 799-6124