[FM Discuss] FM upstream to Sugar Labs

[David Farning]

On Thu, 2008-06-26 at 21:59 -0500, Anne Gentle wrote:
> I have ideas for getting more energy behind some of the separate doc
> deliverables we could target, and have already sent out a couple of
> emails, especially in pursuit of a Turtle Art "manual" that a
> Houstonite put together, and I think she'd be willing to post it on
> FM. 

It is going to be interesting to see how we end up handling activities
such as Turtle Art.  What I would like to see happen is that translated
versions of your guides are shipped with the activities.

We are trying to adopt addons.mozilla.org to use as a possible activity
distribution point. Ideally, document writers will upload snapshots of
their work to addons,  translators will do their thing, and the final
product will be shipped along with the activity itself.

> So, an approach would be similar to what we've done before - when we
> have a well-defined task analysis and outline for a manual, we start
> recruiting writers for it. If writers volunteer, we can have specifics
> for them to work on.

I can start putting together list of topics which we feel are important.

We have been assembling the very sparse documentation under
http://wiki.sugarlabs.org/go/DocumentationTeam on our wiki.  Sorry the
team space is such as mess.  I really didn't know where to get started. 

> As for tracking doc bugs and requests, I'd love to have doc requests
> prioritized just like software bug are prioritized. That approach
> would let us figure out how to "staff" the different projects and also
> would work well towards a Book Sprint. Adam, I have a writer her in
> Austin who was just asking about that on her blog, and maybe we could
> get her and one other interested person to write for a burst of time
> if we have a prioritized set of docs to work on.

We use a bug tracking system called trac.  It might be a bit of over
kill...

> Um, let's see, does that cover the spirit of the questions and
> approach? I hope I'm not missing anything or misrepresenting a typical
> approach. 

When would you like to hold a sprint?

Thanks again,
dfarning