2009/12/28 Martin McClure <martin@hand2mouse.com>:
Adrian Kuhn wrote:
I know that originally all Smalltalk comments used 1st person. What is  your take on that?
Martin always writes in first person. :-)
Actually, I usually do prefer to use first person when writing Smalltalk comments. I find that anthropomorphizing objects helps to think in an object-oriented way.
This bias is built into the language with the keyword "self".
+1 I find it more encouraging for use , when classes has comments written in a 1st person style. Because, psychologically, i feel that i can trust to delegate certain tasks to given object, while if i read a 3rd person comments, i am usually think that this is a part of something bigger, which is incomplete (wont work) alone, and so, i should use it carefully.
Regards,
-Martin
_______________________________________________ Pharo-project mailing list Pharo-project@lists.gforge.inria.fr http://lists.gforge.inria.fr/cgi-bin/mailman/listinfo/pharo-project
-- Best regards, Igor Stasenko AKA sig.