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

[Walter Bender]

On Sun, Dec 20, 2009 at 12:05 AM, Jim Simmons <nicestep at gmail.com> wrote:
> 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.

I think we could readily make a case study of using git (and
gitorious). The same would go for the other appendices you suggest.
That said, including them as appendices instead of in main flow makes
sense.

regards.

-walter

> 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
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
>



-- 
Walter Bender
Sugar Labs
http://www.sugarlabs.org