Mechanic,

I'm not sure where you got the squeakbyexample.org url but the website seems to point to here: https://hal.inria.fr/inria-00441576/document from here https://squeak.org/documentation/

Having the documentation be outdated and not working with the current version is a problem for software all around the world. Even more so for an open source community. I completely agree with you that beginner samples need to be maintained so that they stay relevant to new versions of the software. Unfortunately, that is a very difficult thing to do. It would be nice to have a seperate version specific documentation section on the website and a team of people who would move the documentation forward on each new release. What we need to make that happen is the web team to provide that framework for the documentation and a documentation team to volunteer to do the work and write or modify the docs.

Tty's method http://www.squeaksource.com/SeasideDoc.html is nice because it is documentation that goes with the program and it's versioned but it would be better to have something that is accessible and filterable by version on the squeak.org website.

We just may not have the resources we need to make that happen. By the way have you looked at the http://wiki.squeak.org/squeak and https://squeak.org/documentation/ pages? There is a lot of really good documentation out there but it does take some digging and you probably will run into issues related to different versions. Much of it should still be relevant. If you run into issues we are here to help!

All the best,

Ron Teitelbaum

On Thu, Jan 16, 2020 at 7:16 AM mechanic <chrisgame@pobox.com> wrote:

Ron,

Interesting that there is an 'oversight' board but we have to wonder what
oversight is actually applied? There are many queries on here (one or two
from me) showing that there are issues with finding appropriate and up to
date docs covering basic setup and operating issues. As an example, much of
that points to the squeakbyexample.org site which seems to have been taken
over. As well as that, there are many versions of Squeak on the web, and not
much guidance as to which docs and guides work with what versions. There
seems an overall cleanup project missing? I also wonder why there are so
many expert-level queries on a list supposed to support beginners, perhaps
some of that is off-putting to newbies?

--
Sent from: http://forum.world.st/Squeak-Beginners-f107673.html
_______________________________________________
Beginners mailing list
Beginners@lists.squeakfoundation.org
http://lists.squeakfoundation.org/mailman/listinfo/beginners