On Sat, 7 Feb 2004, Lex Spoon wrote:

> material to help out new users.  If I wanted to try and make Squeak
> easier for new users, these things look more promissing than writing
> more tutorials:
>
> 	- the content and organization of the initial image
> 	- the organization of www.squeak.org
> 	- the organization of the swiki
>
> Or if writing is what someone feels like doing, it seems more productive
> to pick one area of Squeak and document it.  In particular, going
> through the image and adding class comments and example methods would be
> extremely helpful to new users.

THREE CHEER FOR LEX'S OBSERVATIONS! CHEER! CHEER CHEER!

(the caps is meant to be cheery, not shouting.)

Particularly the last observation... When peeking around the image, I
often wonder "what is this class for?  what does this method do? when and
why would I want to use this class and/or method? Is this a system thingy
I don't want to mess with, or is it something I will want to use in my own
programs?" There's very slick ways to see who calls a particular method,
etc., put just a few comments at the beginning of every method would go a
long way..."

- Aaron