[Seaside] Re: Why seaside really sucks! COMMMMMMMENTS are MISSING

[nicolas cellier]

Comments should also tell about implicit conventions.
Remember my post on squeak dev about morphic heading

I do not know the unit (degrees radians ?)
I do not know the origin (toward upscreen, right ?)
I do not know direction (clockwise, counter clockwise ?)

Reverse engineering the code is not the fastest way to the information...

As for the first person, remember objects know about themselves, this is 
called reflexivity (self = ego = I).

Nicolas

Jason Johnson a écrit :
> Yea, I figured it had to do with "live objects" and everything.  I just 
> find it a bit distracting (like as in, when you go to the theater and 
> they put in about 3 more previews then normal before your movie), but 
> it's not a big deal.
> 
> tim Rowledge wrote:
>>
>> On 12-Apr-07, at 12:05 PM, Jason Johnson wrote:
>>
>>>
>>> And what is with the first person commenting?  For me it doesn't add 
>>> anything but typing/reading, with no value add.
>>>
>>> "I am the method responsible for rendering the class..."
>> The tendency to first person comments stems from the anthropomorphic 
>> viewpoint of being inside an object.
>>
>> tim
>> -- 
>> tim Rowledge; tim at rowledge.org; http://www.rowledge.org/tim
>> Useful Latin Phrases:- Die dulci fruere = Have a nice day
>>
>>
>> _______________________________________________
>> Seaside mailing list
>> Seaside at lists.squeakfoundation.org
>> http://lists.squeakfoundation.org/cgi-bin/mailman/listinfo/seaside
>>