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

karl ramberg karlramberg at gmail.com
Wed Oct 7 10:16:26 EDT 2009


On Tue, Oct 6, 2009 at 11:11 PM, Rita Freudenberg <
rita at isg.cs.uni-magdeburg.de> wrote:

> 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
>
>
>
> _______________________________________________
> squeakland mailing list
> squeakland at squeakland.org
> http://lists.squeakland.org/mailman/listinfo/squeakland
>

*It's good to have a style for the writing to look at so the documentation
get a coherrent apperance.*
*I have not read the Turtleart one yet so maybe it will give us a few hints.
*
**

*Karl*
**
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.squeakland.org/pipermail/squeakland/attachments/20091007/e0c54cb8/attachment-0001.html


More information about the squeakland mailing list