On Fri, Apr 19, 2002 at 08:31:03PM +0200, Maarten Maartensz wrote:
Hello Carl,
At 08:57 19-4-02 -0700, you wrote:
<snip suggestion to accept only documented code>
I have less than 1/14th of your experience with Smalltalk (but 14 years with Prolog, mostly, from which I have drawn a similar lesson about documenting and commenting code), but my initial reaction is: This sounds like a GREAT idea!
I like it as well.
<snip>
O, and please do not write Comments on the line of "I (this piece of comment on this piece of code) am ... " etc. For this is just categorical nonsense: Prose is not animated.
I have no problem with classes commenting on themselves in the first person. I think that it encourages you to think in an object-oriented manner.
<snip>
Joshua