Proposal: Squeak book published by O'Reilly: was Re. Document
ation
Pennell, David
dpennell at quallaby.com
Fri Jun 11 00:12:21 UTC 1999
I used Tim Olsons SameGame as a learning tool for teaching my son
about Squeak. We first changed the squares to circles (I have a
KDE version that using spinning spheres that would be nice to do
in Baloon3D...). We then added a HallOfFame to record top scores
with names. This was last Christmas before I started the new job
and I haven't been able to follow through with it. I think there
are probably many opportunities to continue this.
-david
> -----Original Message-----
> From: Edward P Luwish [mailto:eluwish at uswest.com]
> Sent: Thursday, June 10, 1999 2:51 PM
> To: squeak at cs.uiuc.edu
> Subject: Re: Proposal: Squeak book published by O'Reilly: was Re.
> Documentation
>
>
> In response to both the O'Reilly and ANS Standard suggestions for
> documents:
> Both formats are somewhat foreign to the Smalltalk traditions, which
> successfully introduced the system/language/culture to thousands of
> users, including myself. The original Blue Book was a brilliant
> document in this regard, in that it had no precedent, and is still
> useful. It has lots of pictures and diagrams, and even the
> "plain" text
> presents Smalltalk in a form similar to what you see in a browser.
> O'Reilly uses a pretty much "tried and true" format and almost never
> deviates from it, one that is suitable for terminal-based programming
> systems like Unix Shells, C++, Java and Perl. ANS is even more
> restrictive - the C++ standard had to be "annotated" and in a somewhat
> more flexible printed format before anyone was able to
> understand it at
> all.
>
> I would like to see a "scavenger hunt" with hints as the sole
> documentation outside the actual source and the Swiki "oral history".
> [As you can see, I have been converted by the Smalltalk
> purists who have
> written in this thread, as well as by some reading of printed
> html-ized
> sources courtesy of printOut.] Maybe it would also be nice to make
> downloadable snapshots of the Swikis for the benefit of nomadic
> Squeakers who take their laptops into wilderness campsites.
>
> For the scavenger hunt, let's accumulate a graded series of little
> projects which could be of benefit to Squeakers of all
> levels, add some
> hints, like using "sendersOf", that take the user directly into the
> read-some write-some environment, and put them into a readme, web page
> or CDROM jewel box insert. Then let the fun begin.
>
> Ed
>
More information about the Squeak-dev
mailing list
|