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

Walter Bender walter.bender at gmail.com
Wed Sep 3 13:27:37 EDT 2008


What is the plan for the Activities manuals?

-walter

On Wed, Sep 3, 2008 at 12:06 PM, Anne Gentle <annegentle at gmail.com> wrote:
> Thanks Seth
> I want to confirm a few details with you -
>
> Is the format HTML, zipped into a zip file renamed to .xol?
> Does it need a manifest file as well in the .xol file?
> Do I just upload it to the wiki?
> What time of day do you need it by?
> Is there any additional format you need?
>
> Thanks,
> Anne
>
> On Tue, Sep 2, 2008 at 4:49 PM, Seth Woodworth <seth at laptop.org> wrote:
>>
>> 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
>>>
>>
>
>
> _______________________________________________
> Library mailing list
> Library at lists.laptop.org
> http://lists.laptop.org/listinfo/library
>
>


More information about the Library mailing list