=== Top of the Swiki === Attachments ===

Web Site and Tutorials

Note: Before making changes to this page, please read the
guidelines to SqueakCentralProjects. Thanks.

Goal
We have combined these two areas because ease of access and newbie perspective are central to each. Much of the discussion on the web site topic had to do with adding pictures and making a clear distinction between that which comes with Squeak, and other things that have been done with Squeak.

Estimated completion date: December 31, 1999

Status
[August 8] project declared to exist

Implementors
who?

Q/A, Integration

General Commentary
A list of items (most recent last) of the form
[date, author] comment
Anyone is invited to add to this list.
The implementors are free to remove and summarize any items more than two weeks old.

[Aug 19, Tyrrell] ( UPDATED Sep 09 ) I originally offered the use of a Swiki that I had set up for organizing links and information about Squeak. However, since that time I've reorganized my Swikis and then found that Swikis seemed a bit fragile to traffic, so I've replaced them all with WikiWorks sites. Also, initially the pages I hosted were interwoven with other Squeak and SqueakWeb related pages on my Squeak Wiki, adding to the confusion. My Squeak Wiki is actually being set up for a different purpose, and in particular one project I am working on that is described there called "The Visible Squeak" could be confused with this project. I've also grown a bit concerned that my making a Wiki available for use by others working on website and tutorials might be construed to mean that I am somehow organizing things, which I am not.

So, just to be clear- There exists a dedicated Wiki, separate from my other Wikis, that I've set up at (http://oasis.canis.uiuc.edu:8080/SqueakWeb) which folks may use in any way that they see fit, provided it has something to do with Squeak web sites and tutorials.

[Aug 20, Bergmann] The Squeak Tutorial swiki should be more medial with limited write access only for registered squeak authors. These authors must be familar with squeak and html. They can register and should organize herself by a special swiki page including responsibilities.

See an homepage example, an overview page example, and an description page example to see how it could look like. We need a special section with tutorials for beginners, advanced users, ... and with tutorials on special topics - morphic, ... including pictures, ...

I think we also need:
In summary we need a swiki parallel to the discussion swiki showing only the stable content of squeak (the JavaSoft.com for Squeak) with a little more bits and pieces (images, web style, ...).


[Aug 20, Hannes Hirzel] Thank you Thorsten for the work you already did documenting Squeak on the phaidros web site. For the time beeing I consider this Swiki to be a good place for writing documentation. I don't perceive any problemes which would force access restriction. Already this swiki served as a preliminary Squeak documentation. Actually the possiblilites of this swiki for organizing the documentation tasks are not yet used fully. Using it further has the advantage that the work can be done without further delay.

So a list with Tutorials - tasks to do could serve as a starting point.

Also a cooperation with the author(s) of the Squeak section of www.dmoz.org (http://dmoz.org/Computers/Programming/Languages/Squeak/ should be sought. There is a free use license for the information content collected on that site (http://dmoz.org/license.html).

Could somebody set up a mirror of this swiki somewhere for backup? So the Squeak community woudn't be solely dependent on the system backup of this Swiki server. And if this Swiki is inacessible for some reason the documentation can still be used by means of a non user editable content web server. Perhaps the http://www.squeak.org web server could be used for this purpose.

What about the copyright status of the work done within this Swiki? Is the Squeak license beeing applied?

[Aug 20, Tyrrell] ( UPDATED Sep 9 ) Mentioned placing one of the above example pages into a Swiki, and several Swiki and Wiki pages I had which are now defunct ( see my updated Aug 19 entry ). Also mentioned that code exists to traverse a Wiki gathering all of its pages- I haven't tried that yet.

[Aug 20, Hirzel] Does this mean you are considering doing a mirror of http://minnow.cc.gatech.edu/squeak.1?
If so please open a "mirrors" section on the front page. Or perhaps just "snapshots" and a date, if if the mirror is not updated daily. Pay attention not to crash this wiki by getting pages without enough delay between requests.

[Aug 20, Tyrrell] Not exactly, but that is worth considering. I had a more limited scope in mind, such as mirroring the projects portions of that Swiki. However, I don't have the code that traverses other Wikis, so I don't know what it can do other than what is described at http://brain.cs.uiuc.edu/VisualWorks.WikiWorks .

[Aug 20, Hirzel] So itīs probably easier to do this using a standard technique. hh wrote an email to Mark Guzdial to ask him for permission for mirroring this wiki. His answer will be put on this page.
Who has web space available and could set up a mirror of this swiki?

[Aug 27, Tyrrell] I've replaced my Swikis with VisualWorks Wikis. My Squeak Swiki is being rebuilt at (http://oasis.canis.uiuc.edu:8080/Squeak), and a SqueakWeb Wiki has been created at (http://oasis.canis.uiuc.edu:8080/Squeak). As for previous mirroring questions, I believe that it can be done using a WikiWorks server, with some additional code to check a Swiki's Recent Changes section. To do this will require the "WikiSucker" code that is currently missing from the WikiWorks 0.5x release. The caveat is that WikiWorks servers use a different set of markups, but these are not hard to learn. The benefit is that I believe the WikiWorks server will be much more stable than the Swiki is right now.

[Sep 29, Tyrrell] A month without updates is a bit worrisome- anyone out there?