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

[Seth Woodworth]

Hi Anne,

I'm going to be bundling the html files into a custom activity that was
rolled for this very purpose.  It's going to be the Help.xo activity and is
going to be the first activity on the XO.

Right now I'm just going to be able to remix a few chapters and spin out an
html doc, then add a little extra url-nav.  That deadline is a little after
friday, so we can talk about that once we get the content polished.

I'm collecting edits now and I'm going to be typing and editing for the next
several dozen hours. :) Updates to this list very soon!

-Seth

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
>>>
>>>
>>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.laptop.org/pipermail/library/attachments/20080903/7603f3b0/attachment.htm