Proposal: Squeak book published by O'Reilly: was Re. Documentation

Edward P Luwish eluwish at uswest.com
Thu Jun 10 18:51:20 UTC 1999


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