Hi,
I have used may parts of the system and could write some documentation, but I was wondering if we should have a format, or style for these ?
Do you have any suggestions or know some prior art/ documentation we could be inspired by.
Karl
Am 29.08.2009 um 12:58 schrieb Karl Ramberg:
Hi,
I have used may parts of the system and could write some documentation, but I was wondering if we should have a format, or style for these ?
Do you have any suggestions or know some prior art/ documentation we could be inspired by.
Hi Karl,
I would like to have an Etoys documentation in FLOSS manuals: http://en.flossmanuals.net/
There you can find several OLPC & Sugar documents, and I think an "Etoys Activity" is missing :) I think of a documentation where every part of the system is described, every tile and every object etc. I wrote an email last week to someone at FLOSS manuals and I hope they will prepare what is needed that we can start writing. For now, you can register at their website and explore what is there. I think it is a very useful tool and since so many people with XOs are using Etoys, it might be the right place to put it besides the other sugar and OLPC documentation. Of course, we can extract .pdf files and put these wherever we want. I will send detailed information to the lists as soon as we can start.
Greetings, Rita
Karl
etoys-dev mailing list etoys-dev@squeakland.org http://lists.squeakland.org/mailman/listinfo/etoys-dev
Rita Freudenberg rita@isg.cs.uni-magdeburg.de
On Aug 29, 2009, at 8:18 AM, Rita Freudenberg wrote:
Am 29.08.2009 um 12:58 schrieb Karl Ramberg:
Hi,
I have used may parts of the system and could write some documentation, but I was wondering if we should have a format, or style for these ?
Do you have any suggestions or know some prior art/ documentation we could be inspired by.
Hi Karl,
I would like to have an Etoys documentation in FLOSS manuals: http://en.flossmanuals.net/
There you can find several OLPC & Sugar documents, and I think an "Etoys Activity" is missing :) I think of a documentation where every part of the system is described, every tile and every object etc. I wrote an email last week to someone at FLOSS manuals and I hope they will prepare what is needed that we can start writing. For now, you can register at their website and explore what is there. I think it is a very useful tool and since so many people with XOs are using Etoys, it might be the right place to put it besides the other sugar and OLPC documentation. Of course, we can extract .pdf files and put these wherever we want. I will send detailed information to the lists as soon as we can start.
Greetings, Rita
IMO, we should have documentation on both our wiki and/or website and FLOSS, etc.
Keeping the text & images synchronized is the key, otherwise we'll have variation problems.
More discussion needed.
Tim
On Aug 29, 2009, at 6:58 AM, Karl Ramberg wrote:
Hi,
I have used may parts of the system and could write some documentation, but I was wondering if we should have a format, or style for these ?
Do you have any suggestions or know some prior art/ documentation we could be inspired by.
Karl,
Add pages at will to the wiki under "Documentation" . . . we will later take this text and make it pretty using our textbook graphic design, so people can download a PDF.
And thank you for kickstarting this!
Tim
etoys-dev@lists.squeakfoundation.org