[OLPC library] DEADLINE, was: updating of the docs on FLOSS Manuals

Seth Woodworth seth at laptop.org
Tue Sep 2 17:49:50 EDT 2008


Hey everybody,  Thank you all so much for participating in the BookSprint.
This manual looks great and is going to be a huge help.

As far as packaging this book goes, we need to finalize updates by Friday or
the changes wont make it into the shipped manual on the XO.  So please make
the most important updates quickly.

After Friday there is still going to be a huge need for ongoing
documentation. Keep up the excellent work everybody!

All the best,
Seth Woodworth

On Tue, Sep 2, 2008 at 8:05 PM, Anne Gentle <annegentle at gmail.com> wrote:

> Hi everyone,
> Having had a nice 3-day weekend to recover from the high-energy week of the
> BookSprint, I wanted to give you some ideas for maintenance of the manuals
> going forward.
>
> Daniel's review of the manuals was extremely helpful and I believe we've
> incorporated all his suggestions. If you only have time to read and write up
> notes, sending an email to the Library list is a good way of getting your
> suggestions to the writers. Or, as Adam Hyde suggested, make the changes
> yourself, but if you simply don't have time for that, an email listing your
> review comments is perfectly acceptable.
>
> Documentation in some organizations is an integral part of the development
> process, and you can log and track bugs against the documentation. The OLPC
> Trac system can do this to a point, but there is a lot of signal to noise
> there for writers to keep up with. I'd personally prefer that you use the
> FLOSS Manuals wiki system to either go ahead and make the changes yourself,
> or comment on the chapter that you have suggestions for, or email your
> comments to either me or this list.
>
> As the maintainer, I'll be keeping an eye on all changes and all comments
> to the manuals. We've already got a good comment from someone saying that
> since the networking chapter addresses 8.2, how about creating another
> chapter for the 6nn and 7nn deployments that are active today? With FLOSS
> Manuals remix capability, this request seems do-able. I'd like to hear
> commentary on that from this group though.
>
> For additional concepts that you do not feel are covered in the manuals but
> are not "bugs" technically with the manual, please post to this Library list
> so that me or one of the other community writers can find a way to
> incorporate it.
>
> I believe my role going forward is a central person for doc requests, but I
> do want to build redundancy in the system so I'm not the only resource
> available for doc.
>
> Thanks all for your contributions last week, and I look forward to
> continued improvement as we go forward.
>
> Anne
>
> _______________________________________________
> Library mailing list
> Library at lists.laptop.org
> http://lists.laptop.org/listinfo/library
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.laptop.org/pipermail/library/attachments/20080902/1e29f6f6/attachment.htm 


More information about the Library mailing list