Learning Squeak

Les Tyrrell tyrrell at canis.uiuc.edu
Mon Jan 21 16:26:09 UTC 2002


----- Original Message -----
From: David T. Lewis <lewis at mail.msen.com>
To: <squeak-dev at lists.squeakfoundation.org>
Sent: Monday, January 21, 2002 6:47 AM
Subject: Re: Learning Squeak

> > > > <gripe>
> > > > Nonsense, the tools are not the problem. Posting classes with no class
> > > > comment and methods listed in the 'as yet unclassified' category is
just
> > > > plain sloppy. It takes 10 minutes to write a comment and put methods
into
> > > > meaningful categories, and it takes your readers many times that long
> > > > to figure out how things work if you don't bother.
> > > > </gripe>
> > >
> > > BAH!  I believe the tools can definitely have an impact.
> >
> > I agree 100% with Les on this.  Making the comment appear by default will
> > make it more obvious that one is being 'sloppy' by not including a
comment.
>
> You're right, and I should not have suggested otherwise. Sorry.
>
> I continue to hold my opinion about posting undocumented code (but I
> won't gripe about it any more ;)

Not a problem with me- the gripe about undocumented code is fine by me- we
might disagree about a documentation style, but the need for it is still
there.

As for the role of tools in this situation- we should put that to the test.

Take care!

- les





More information about the Squeak-dev mailing list