[Sugar-devel] Several chapters of "Make Your Own Sugar Activities!" ready for review, feedback

[Gary C Martin]

Hi James,

On 5 Jan 2010, at 19:57, Jim Simmons wrote:

> I've been working on a Floss Manual that should be a beginner's guide
> to creating Sugar Activities.  I've got 64 page's worth (in the PDF
> version) written and I feel confident that I will finish this book
> eventually.  What I have now may be good enough to criticize.  It
> contains some pretty good code samples, some reasonable
> recommendations, and a fair number of screen shots.  So far it covers
> writing a basic Activity in Python, running it with sugar-emulator,
> and getting the code in Git.  Future chapters will include doing i18n
> with Pootle, distributing the Activity, doing text to speech with and
> without highlighting, and collaboration features.  I may stick
> something on Activity debugging techniques in somewhere too.
> 
> Other stuff that *should* be included, but which I am not currently
> qualified to write, would include:
> 
> * Developing Activities on a Mac

I'll try to help here, though I'm not sure how 'Developing Activities on a Mac' really differs from any other platform, though I'm sure I have a few shiny reality distortion platform habits of choice that may be of use to others ;-)

> * Creating an Activity using PyGame instead of PyGTK.

Maybe can help here as well, Physics originally is a PyGame (and others) construct, though I'm not convinced how elegant the code really is. Wade has been working on sugargame as an improved over the original olpcgame sugarising effort, so would be good to focus on that, I think (see Physics git rep and Wade's clone I hope to merge moving forward).

> * Creating the new-styled toolbars
> * etc., etc.
> 
> If you want to check out what I have the URL is:
> 
> http://en.flossmanuals.net/ActivitiesGuideSugar/Introduction
> 
> Any help anyone can provide on this will be greatly appreciated.  If
> you want to register as a writer and contribute stuff of your own or
> edit my stuff you have my blessing.

Will try to allocate some cycles!! Many thanks for rolling the die and taking the leap to get this doc going.

Regards,
--Gary