[ANN] Squeak Documentation Project

Matthew Fulmer tapplek at gmail.com
Thu Sep 21 17:58:38 UTC 2006


On Thu, Sep 21, 2006 at 09:44:27AM -0700, Eric Winger wrote:
> This is one of the problems with Smalltalk in general, as I see it. 
> There's a ton of documentation available on Smalltalk, not just Squeak. 
> But when you're starting out, you don't want all that. You need a 
> straight forward, single, starting point to get going.

That is what I hope to create.

> The stic group, through the smalltalk-central.com site is trying to 
> centralize a lot of Smalltalk information into one place for people 
> curious about Smalltalk.

Should the squeak documentation project focus it's efforts at
that site, rather than the Swiki?

> Right now, in the tutorials sections on smalltalk-central.com, there 
> are inumerable tutorials on squeak and aspects of squeak. Where does a 
> newbie start?
> 
> It would be nice to get a squeak tutorial that is concise, 
> well-written, well-formatted and designed for the beginner. If nothing 
> else, so he doesn't have to wade through 50 tutorials to get started.

To begin, I want to create a comprehensive index of all existing
Squeak-applicable documentation. That way, we know what we can
plagiarize and what we will need to write from scratch. Of
course, I do not want to use someones work without permission,
but I do not know of a categorical index to all the available
documentation. I have created a template index, and I will begin
creating content there soon:

http://minnow.cc.gatech.edu/squeak/5871

Once that progresses, we can obtain permission to use those
documents that are available and re-create them in the form of a
comprehensive Squeak Reference Manual and a Tutorial. That is my
road map.

-- 
Matthew Fulmer



More information about the Squeak-dev mailing list