[FM Discuss] [IAEP] Book sprint aug 16-23

Wed Jul 9 06:55:21 PDT 2008

Hi again everyone -
I'm feeling déjà vu. :) We had the same discussions last year trying to meet
a ship deadline and some volunteers got really burned out trying to get a
finalized English version in time for about 8 translations... the effort was
intense, but not long lasting, and now here we are again. :)

I agree that we meet the Aug 10th deadline by distinctly defining what it is
that ships on that date. I would say that a PDF or HTML English version that
ships with Sugar is a good goal for starters. How can I find out what needs
to be different about the current manual? What are our priorities for
additional content? Which Activities are highest priority? David or Walter,
do you have time for a Skype chat this week? Or shall we talk about this at
a Thursday con call? Any time but 10 am CST or  4 pm CST works for me.

Adam, I'll take a first crack at creating chapters, and I was just going to
ask you how best to structure the Activity docs/chapters in a way you think
they'd work well in FM... do you have the time for a Skype chat after your
book sprint work is done today? (so sorry this activity is overlapping so
much! You must be getting whiplash!) :)

Could we use the http://wiki.sugarlabs.org/go/DocumentationTeam page to
start mapping out who could take which chapters?

Here are my ideas, and I'll also put this on the wiki page
* Write Getting started guide updates for the changes in the build, ensuring
the hardware dependencies are lifted.
* Write Activities individual chapters (or books?) heavily tutorial-scenario
based. Christoph, thanks so much for working on Record.

Audience is kids and teachers. While programmer doc is listed on the
documentation page, I think FM has a different audience in mind. Let me know
if that needs to change.

Please let me know if that's enough focus for now and I'll start building
scaffolding after getting clarity at Thursday's meeting.

Thanks,
Anne

On Wed, Jul 9, 2008 at 5:07 AM, adam hyde <adam at flossmanuals.net> wrote:

> my preference is that we bite off something digestable....
>
> I would recommend that we meet the aug deadline for shipping the docs by
> doing work on irc and...shock horror....the web! ;) we have the
> tools...we could then structure docs in fm (floss manuals) and assign
> chapters all via irc/email. Anne knows the tools well and can set up the
> manuals according to spec and then we start writing immediately...some
> of us could contribute also from Wikimania (I will be there as I expect
> Mako will be and there surely will be an OLPC/Sugar presence like last
> year)
>
> then the booksprint still happens but it is a concentrated blast, and an
> effort to consolidate the working collaborations to better ensure
> ongoing commitment to the docs and a good opportunity to get everyone
> heading in the same direction
>
> also... can I suggest that we keep this on the FM Discuss Mailing list
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
>
> I think we are dropping people out of the conversation accidentally with
> these cc lists.
>
> adam
>
>
>
>
>
>
>
>
> On Tue, 2008-07-08 at 22:21 -0700, Edward Cherlin wrote:
> > On Tue, Jul 8, 2008 at 10:11 PM, Seth Woodworth <seth at laptop.org> wrote:
> > >
> > >
> > > On Tue, Jul 8, 2008 at 11:38 PM, David Farning <dfarning at sugarlabs.org
> >
> > > wrote:
> > >>
> > >> Seems like we have support for the idea of a book sprint.
> > >>
> > >> Considerations:
> > >> Time - Version .82 will be released Aug 10th. Is it worth it to try to
> > >> hit that release date?  As much as I would like to say yes, we should
> > >> not push things too fast.  My key goal in setting up the sprint is to
> > >> create a _concrete_ event where people can come together to and help
> > >> OLPC.  Let's take our time and use this as a test run at community.
> > >
> > > As much as I would like a complete set of documentation for Sugar, if
> we can
> > > get the event done sooner it can ship on thousands of G1G1 machines.
>  This
> > > is an important consideration.  Can we make a list of who could make it
> to
> > > Boston in a very short period of time for a Sprint and decide from
> there?
> >
> > Let's look at it another way. How much needs to be done to get
> > something ready for this release and shipment? How inaccurate is the
> > current manual?
> >
> > Can we do that task online, starting right away, and then have the
> > sprint for whatever is appropriate after that? I can rearrange my own
> > schedule somewhat to accommodate an important rush project.
> >
> > >> Location - Seth mentioned the availability of space at the OLPC's
> > >> offices.  That would be great if it were possible.  The marketing
> angle
> > >> of volunteers coming together to olpc's offices for a sprint would be
> > >> great.
> > >
> > > One way or another, locations will be had here in Boston.  Kim approved
> > > support for the event at the 1cc office so long as both conference
> rooms
> > > aren't booked.  And even spilling over onto MIT isn't that big of deal.
> > >
> > >
> > >>
> > >> The Big question is would Adam and Anne feel comfortable running the
> > >> sprint on OLPC's turf.  Adam and Anne are the domain experts.   We
> need
> > >> to give them the room to leverage the OLPC effort and enthusiasm
> against
> > >> FM's experience.
> > >>
> > >> Participantes -
> > >> Anne Gentle - Texas
> > >> Adam Hyde  - Netherlands
> > >> David Farning - Wisconsin
> > >> Walter Bender - East coast
> > >> Greg Dekoenigsberg - ?
> > >> Others - ??
> > >
> > > Might I also add Benjamin Mako Hill [Boston] (author of the Official
> Ubuntu
> > > book and sometime OLPC employee), and Ron Hale-Evans [Seattle]
> (technical
> > > author via O'Reily, Fellow OLPC/Sugar nut and Linux Foundation
> Employee).
> > > Personally I've been the editor of my college newspaper and am familiar
> with
> > > explaining Sugar internals in a non-technical way.
> > >
> > >>
> > >> I will gladly step aside to let a better writer take my spot;)
> > >>
> > >> Funding - Between $500 - $1250 per person.
> > >> I'll do the leg work, but cold calls from dfarning won't be worth
> much;(
> > >>
> > >> Talking to book publishers-- Is FM interested in going that direction?
> > >>
> > >> How about setting a tentative date for Aug 16-23?
> > >
> > > I would still like to consider *some* event sooner with the expectation
> of
> > > getting it into the 8.2 build.
> > >
> > > _______________________________________________
> > > Its.an.education.project mailing list
> > > Its.an.education.project at lists.lo-res.org
> > > http://lists.lo-res.org/mailman/listinfo/its.an.education.project
> > >
> > >
> >
> >
> >
> --
> Adam Hyde
> FLOSS Manuals
>
> http://www.flossmanuals.net
> + 31 6 2808 7108
>
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.flossmanuals.net/pipermail/discuss-flossmanuals.net/attachments/20080709/b96cd452/attachment.htm>