[squeakland] Let's write the Etoys reference manual!

[Rita Freudenberg]

Hello everyone,

we do have a place now to write an Etoys reference manual:

http://en.flossmanuals.net/bin/view/Etoys/WebHome

Using FLOSS Manuals, everyone can just click on the above link and  
start writing using your web browser. You have to register on their  
page and then you can login. What we have by now is just an outline,  
we can change it if we find out later that we need more or other  
chapters. But for now let's start with
Introduction
Getting Started
User Interface
Objects
Tiles

We can probably write the introduction when everything else is done.  
Getting started should cover technical details on how to start Etoys,  
this is a reference manual, no teaching guide. For the other chapters,  
everyone who wants to help just pick an object, tile or item of the  
user interface, describe what it is and what it is for and add a  
picture.
Writing with FLOSS manuals means, everyone else can read what you have  
written and can change it. So don't hesitate to start writing, even if  
you are not really sure about something, someone else will come and  
change what's wrong :)
We start writing in English, but we can manage translations later. The  
manual will not be publicly available while we are writing. To get an  
idea how it could look like, here is the TurtleArt documentation:

http://en.flossmanuals.net/turtleart

The main reasons to use FLOSS manuals are that it is used by OLPC and  
Sugar and we can reach that community and we can get help from the   
activists from the other projects in translating or proofreading.

Also, we can get a .pdf at the end, not just text on a website. If you  
want to know how that looks like, here is a link to the TurtleArt  
manual:

http://en.flossmanuals.net/TurtleArt/FM_TurtleArt_06Sep08.pdf

Please let me know if you have any problems with FLOSS or what and how  
to write!

Greetings,
Rita


Rita Freudenberg
rita at isg.cs.uni-magdeburg.de