Our first book sprint was a great kick-off for our effort to write the Etoys Reference Manual. Here you can read how it went and how we plan to go on:
We started the sprint on Monday, December 7th, with a first discussion about the structure, target audience and FLOSS Manuals. We started writing the first parts then and met again for an audio call on Tuesday. We had a longer discussion and agreed on the structure now available on the wiki page:
http://wiki.squeakland.org/display/sq/Book+Sprint
On the other days I had audio chats with Cherry, Randy and Stephen Thomas, mostly about upcoming issues. We used mostly Sykpe for that, sometimes the FLOSS Manuals chat and some things has been discussed by email.
Where re we now? The manual isn't finished yet, but we made great progress! It is amazing how many things you can discover within Etoys. Randy had several discusison with Yoshiki about World Stethoscope, and now so much information, which previously only existed in the minds of some experts, is going to be available for everyone.
The state of the book in FLOSS manuals related to the outline on the wiki:
The "Introduction" and "Getting Started" chapters are not yet covered. Christine and Karl have been working on the User Interface chapter, namely Halo, Start Screen, Toolbar, Script Editor, Sketching and Viewer. The chapters aren't complete yet, and Overview, Projects, and Keyboard Shortcuts are missing.
The "Common Tiles" chapter consists of a list of tiles to be covered with some explanations already done, it has all ballon help text, but more elaborate explanation is needed.
The most work has been done in the "Objects" chapter, thanks to Randy, Cherry and Stephen. There is only one empty chapter, 5.1 World. The other chapters are in different stages, some only need images, some need more text and we didn't clean up the paragraph yet (regarding the description of PART PIECES).
Regarding images: I'm in contact with FLOSS manuals maintainer to have our images bulk uploaded. As soon as the images are on the server, we can start and add them to the chapters. After that, the first chapters are ready for reviewing. I think, the images are needed to do this, because they will help to understand the text. Reviewing should be done in regard to correctness and understanding. So there will be a mail to the list and all reviewers once we have the first chapters ready!
For now, we will keep working on the manuals as our time allows. We are thinking about a second book sprint week in mid February or March, to finish the book.
We already created some issues on the tracker about the bugs we discovered while playing with Etoys extensively. There are also still several questions in some chapters of the book. I will try to put them on a list very soon and put it on the wiki to get the answers.
Finally, I have to say that I'm very grateful to be part of this effort, it is wonderful to work together with all of you and the others who participated in the book sprint.
Recent Posts
please join us in the Etoys chat channel 08-Dec-09 (teefal)
We're in day two of our Etoys book sprint! Please spend time with us in the Etoys chat channel to help motivate everyone. Usually book sprints are done in person, so we're using our chat channel as a way to spend time together. It's a great way to meet other Etoys enthusiasts and help the writers at the same time. There are two ways to visit our chat channel . . . 1) visit http://chat.squeakland.org and put your nickname in place of "squeaker###". Simply type messages at the bottom of the screen and click Enter. 2) download and install an...
book sprint has started! 07-Dec-09 (rita)
We just had our kick-off audio chat for the book sprint. It is wonderful to have so many great people working together on the Etoys manual! For now, we start writing at FLOSS Manuals Etoys . if you have any questions or want to discuss, try the IRC and start your question with @help ... In case everyone has finally gone to sleep, check out the book sprint page on our wiki or send an email to rita@squeakland.org We will have our next audio chat tomorrow, December 8 at 3 pm EST, 12 PST....
squeak if you like etoys button 06-Dec-09 (teefal)
Try adding this to your favorite webpage: <iframe style="border: none" src="http://squeakland.org/squeakers/squeakerButton.jsp" width="270" height="143"></iframe> It'll look and work like this: We'll be promoting this, along with it's static cousin at: http://squeakland.org/linking/ Want to make sure the flash button (the first one) works on many browsers & websites before going public with it. And yes, I know Flash doesn't work in various places. I'm asking to test this button in the places where Flash works (aka, anywhere you can see a YouTube video)....
First Squeakland Book Sprint 26-Nov-09 (teefal)
Squeakland will have it's first Book Sprint to create a Reference Manual for Etoys! Please join us online during the week of December, 7 to December12, 2009. The book will serve as - the manual you can look up every part of Etoys, - the documentation of what we commit to support in Etoys and - the starting point for other, more elaborate materials. For writing we intend to use FLOSS Manuals. The manual will be available online (html and pdf format), and as a real book per print-on-demand. It will be licensed under MIT, so that we can also...
100 tickets for Etoys 5 24-Nov-09 (teefal)
We've gone through the list of 190+ tickets in JIRA and reduced that to an even 100 for Etoys 5, expected June 2010. http://tracker.squeakland.org If you'd like to champion particular issues, try voting in JIRA, which is now much more obvious because of the Popular Issues tab in JIRA. Simply click on the issue you want, the look to the left and click "Vote for it". This will raise the issue in our awareness :) And if you have any new ideas, simple create the issue. You need a JIRA account to vote or create issues. (It's free and quick...
showcase fixes 09-Nov-09 (teefal)
We had a real backlog of projects waiting to go live on the site. This weekend I tweaked several things and fixed a few bugs, and as a result, a slew of new ballots went out. Now every public project has at least one vote, which means they're all visible. We're up to 102 projects! Quite a selection. Lots of great stuff. http://squeakland.org/showcase/ On a more technical note, I changed the "re-ballot" priority to make things more fair. As ballots expire, projects are picked to get new ballots. Before tonight I favored projects that were the oldest. I've switched to...
Etoys 4 has been released! 24-Oct-09 (teefal)
Squeakland is proud to announce the release of Etoys 4, which you can now download from our website. Special thanks to the Squeakland software team, particularly Bert Freudenberg, Yoshiki Ohshima, and Scott Wallace for their tremendous efforts in the last month. Your hard work really shows! http://squeakland.org/download/ In our Fall newsletter, you'll find some thoughts by Scott Wallace, along with the Etoys 4 release notes which detail the changes you'll find. Of special interest is the new Squeakland Showcase. Everyone can now share their projects directly from Etoys to our website, where the Etoys community can then benefit from the...
squeakland.org now has multiple languages 18-Oct-09 (teefal)
It was a *lot* of work, but squeakland.org is now available in multiple languages. Currently we support English, Spanish, Portuguese, and French. There's much content that needs further translating, particularly for French, but you can see for yourself by changing the language drop-down in the upper-right corner. As a bonus, I've enabled automatic Google translation for project comments and the Squeakers page: http://squeakland.org/squeakers Anyway, we've made a start. If you'd like to add your language to the list, read these two issues and then click "contact" on the website to volunteer: http://tracker.squeakland.org/browse/SQ-481 http://tracker.squeakland.org/browse/SQ-480 There are still some spots that don't...
let us know you're listening 09-Oct-09 (teefal)
If you're reading this message, and you like Etoys, please take a minute and let us know you're listening: http://squeakland.org/squeakers We're trying to get a better idea of the size of the Etoys community. Also, please forward the link to other Squeakers that you know....