[FM Discuss] I'd like to write a manual on Beginner's Guide To Creating Sugar Activities

[Jim Simmons]

Anne,

I've got the six chapters populated more or less as I had planned.  I
hope to follow with three more chapters where I provide code samples
and comment on them.  The chapters and their commentary will be:

7. A standalone Python program for reading etexts.
8. An Activity version of the same program.
9.  Adding toolbars to that program.

 I would of course be interested in feedback on what I have so far.

I have been thinking about how this book should be structured and I
have a thought I'd like to run by everyone.  Walter has suggested
several topics that belong in a book like this but would be hard to
fit in the "case study" approach I'm taking.  What I'd like to do with
at least some of these topics is to create Appendices to the main part
of the book.  We could then have subject matter experts contribute
standalone chapters on these topics:

A. Using Git
B. Implementing Text To Speech
C. Creating Activities That Can Run Standalone
D. A Useful Sprite Library For PyGTK
E. Supporting Multiple Versions Of Sugar
F.  Using Pootle To Internationalize Your Activity

etc., etc.

Please let me know what you think.

James Simmons

On Fri, Dec 18, 2009 at 9:56 PM, Anne Gentle
<annegentle at justwriteclick.com> wrote:
> Hi Jim -
>
> Very helpful, thanks for the audience considerations and the outline.
>
> I've created the manual here:
> http://en.flossmanuals.net/bin/view/ActivitiesGuideSugar/WebHome
>
> It includes the six starting chapters you list, though I did not go
> into each chapter and include your sections you list, nor have I
> arranged them in the correct order. We can do that after you get them
> populated - just send another email to the group.
>
> I hope that gives you a good start! Thanks for bringing it to FLOSS
> Manuals, it's a great match.
>
> Anne