[ANN] Squeak Documentation Project

J J azreal1977 at hotmail.com
Sat Sep 23 13:41:38 UTC 2006


Sounds good.  By the way, this stuff also needs to be pointed to from 
squeak.org.  I think that is the place most new squeak users are going to 
check first so the new doc should be easily found from there.


>From: Matthew Fulmer <tapplek at gmail.com>
>Reply-To: The general-purpose Squeak developers 
>list<squeak-dev at lists.squeakfoundation.org>
>To: squeak-dev at lists.squeakfoundation.org
>Subject: Re: [ANN] Squeak Documentation Project
>Date: Thu, 21 Sep 2006 10:58:38 -0700
>
>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