[OLPC library] goal setting and scope for BookSprint

[Chris Leonard]

On Thu, Aug 21, 2008 at 8:41 AM, Anne Gentle <annegentle at gmail.com> wrote:

> Hi John,
> Thanks for the feedback. You bring up very good points.
>
> > The School Server needs a complete documentation package:
> >  - Installation Guide
> >  - Administrator's Guide
> >  - Troubleshooting
> >
> > We already have two separate User's Guides for the laptop, but nothing
> > for the school server...  (We could say the same about the software!)
>

While I think some prominent mention of XS SchoolServer in this
effort certainly seems like a good idea to encourage more experimentation
with it (acknowledging that a large part of the audience for this doc
will, in it's first version, be new) G1G1 donors).  However, I would agree
with Christoph's comment that extensive documentation on XS SchoolServer may
need to be deferred for a number of reasons:

1) I suspect you will really need to engage Martin Langhoff (XS developer)
to get the best documentation of where XS SchoolServer is now and where it
is going in the near term (e.g. Moodle, etc.).

2) The documentation on the XS on the wiki at the moment is a mix of
operational (e.g. mesh) and aspirational (e.g. back-up).  There seems to be
rapid and recent development going on to realize some of the promise of the
XS ( see for example recent work on back-up
http://wiki.laptop.org/go/Ds-backup ); but without the direct involvement of
Martin Langhoff and/or M Stone OR a lot of testing with a live SchoolServer
set-up, it may be challenging to sort through what is currently functional
and what is still being implemented.

Another aspect of this is that the SchoolServer documentation may naturally
want to live as an appendix to Walter's Deployment Guide
http://wiki.laptop.org/go/Deployment_Guide . I am certainly in favor of work
being done to enhance and improve the excellent start made there.  Again, I
think that may be best accomplished by dragooning in folks from real world
deployments (Oceania, Nepal, Peru, Uruguay, etc.) that would have some
valuable experience to contribute to the practical aspects of XS deployment
and maintenance.  That sort of coordination seems to be out-of-scope for the
current effort, but I think the "hooks" should be left in place to tie the
8.2 (single or small group) XO-based Sugar documentation being developed at
the Jam into future efforts, which is, of course, part of the beauty of
using the FLOSS platform for this effort.

cjl
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.laptop.org/pipermail/library/attachments/20080821/533f11c6/attachment.htm