[Squeakland] Lack of documentation frustrating

[Alan Kay]

Let's see, Oct 31st 2006 to May 25th 2007 seems to be 7 months, not 18 ...

But you are certainly right that much more documentation is needed. 
And, it is actually happening, just slower than hoped. But more of 
various kinds is close to being postable, and will be this summer.

There is also a lot more documentation than you think on the
        http://www.squeakland.org
site. The site needs to be reorganized, but for example, there are 
literally hundreds of pages of documentation, tutorials, curricula, 
etc., done by the very active group at the U of Illinois. And there 
is quite a bit of "other" documentation. There is a book "Powerful 
Ideas in the Classroom" with a dozen or so sequential projects for 
5th graders, etc.

Now, please tell me what it is that you would like to do in Etoys?

Cheers,

Alan

P.S. I don't hate to write documentation, but I'm not very good at it 
and hence painfully inefficient.



At 04:37 AM 5/25/2007, mstram wrote:

>Well, it's been a year and a half since the message I'm quoting was posted
>and there still isn't much on wiki.laptop.org for documentation.
>
>What is the translation between "a few weeks from now." in "programmer
>years" and real-world years ? :)
>
>Man, programmers really hate writing documentation don't they ?
>
>Mike
>
>
>Alan Kay wrote:
> >
> >
> > The documentation is going to get a little more useful and detailed
> > because Etoys will be on the "$100 Laptop" project of the One Laptop
> > Per Child organization ( http://www.laptop.org ) .
> >
> > The test builds of this machine are just starting to happen, and we are
> > starting to
> > write more detailed documentation on the OLPC wiki (
> > http://wiki.laptop.org/go/Sugar_EToys ). This is not worth looking at
> > today, but should have quite a bit of useful stuff a few weeks from now.
> >
> > Alan
> >
> >
>
>--
>View this message in context: 
>http://www.nabble.com/Lack-of-documentation-frustrating-tf2549935.html#a10801283
>Sent from the SqueakLand mailing list archive at Nabble.com.
>
>_______________________________________________
>Squeakland mailing list
>Squeakland at squeakland.org
>http://squeakland.org/mailman/listinfo/squeakland