<div dir="ltr"><div class="gmail_default" style="font-size:small">Mechanic, <br></div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">I'm not sure where you got the <a href="http://squeakbyexample.org">squeakbyexample.org</a> url but the website seems to point to here: <a href="https://hal.inria.fr/inria-00441576/document">https://hal.inria.fr/inria-00441576/document</a> from here <a href="https://squeak.org/documentation/">https://squeak.org/documentation/</a>  </div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">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.  </div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">Tty's method <a href="http://www.squeaksource.com/SeasideDoc.html">http://www.squeaksource.com/SeasideDoc.html</a> 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 <a href="http://squeak.org">squeak.org</a> website.  </div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">We just may not have the resources we need to make that happen. By the way have you looked at the <a href="http://wiki.squeak.org/squeak">http://wiki.squeak.org/squeak</a> and <a href="https://squeak.org/documentation/">https://squeak.org/documentation/</a> 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!</div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">All the best,</div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">Ron Teitelbaum </div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Jan 16, 2020 at 7:16 AM mechanic <<a href="mailto:chrisgame@pobox.com">chrisgame@pobox.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Ron,<br>
<br>
Interesting that there is an 'oversight' board but we have to wonder what<br>
oversight is actually applied? There are many queries on here (one or two<br>
from me) showing that there are issues with finding appropriate and up to<br>
date docs covering basic setup and operating issues. As an example, much of<br>
that points to the <a href="http://squeakbyexample.org" rel="noreferrer" target="_blank">squeakbyexample.org</a> site which seems to have been taken<br>
over. As well as that, there are many versions of Squeak on the web, and not<br>
much guidance as to which docs and guides work with what versions. There<br>
seems an overall cleanup project missing? I also wonder why there are so<br>
many expert-level queries on a list supposed to support beginners, perhaps<br>
some of that is off-putting to newbies?<br>
<br>
<br>
<br>
--<br>
Sent from: <a href="http://forum.world.st/Squeak-Beginners-f107673.html" rel="noreferrer" target="_blank">http://forum.world.st/Squeak-Beginners-f107673.html</a><br>
_______________________________________________<br>
Beginners mailing list<br>
<a href="mailto:Beginners@lists.squeakfoundation.org" target="_blank">Beginners@lists.squeakfoundation.org</a><br>
<a href="http://lists.squeakfoundation.org/mailman/listinfo/beginners" rel="noreferrer" target="_blank">http://lists.squeakfoundation.org/mailman/listinfo/beginners</a><br>
</blockquote></div>