Documentation sprint follow-up

classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

Documentation sprint follow-up

Christoph Derndorfer
Hi all,

apologies for dropping the ball here but things have been quite intense since I left Boston 1 1/2 weeks ago and I'm only now finding some time to re-focus on the documentation work which was started there (and remotely).

First of all I want to thank S Page and Caryl for their continued work and feedback on the various pages over on http://wiki.laptop.org/go/Help_Activity_refresh/TOC - I'll reply to the corresponding e-mails which you've sent along in the past 10 days separately.

With regard to the current status quo a quick check reveals that 28 chapters have been marked [R]eady for review, 17 are in a [D]raft status, 11 are still [E]mpty, and 0 are [F]inal.

As such I see several different things which we'll need to work on in order to move towards having high-quality and up-to-date documentation again:

* Writing: If you have committed to and/or started working on a chapter please try to finish it until the end of the month. If you're unable to set aside any time to work on something that you have committed to or started then please update the information on http://wiki.laptop.org/go/Help_Activity_refresh/TOC accordingly and let us know so we can find others to tackle it.
* Reviewing: With 50% of the chapters having been marked as [R]eady for review it would be great if we could find a small team of 3~4 people to go review all of them. I quickly glanced through some of these chapters and while some are already quite polished others will likely require rework and/or additional information in order to be moved to the [F]inal stage. Let us know if you're willing to work on this important task!
* Packaging: Gonzalo (in CC) got in touch yesterday to see whether we're ready to move the documentation into an updated version of the Help Activity. As mentioned above we're not quite there yet but I really hope that we can finish up everything over the next 2 weeks or thereabouts. I also need to follow up with SJ and Bernie to see what the status of the PDF and .zim (offline wiki) export capabilities on wiki.laptop.org and wiki.sugarlabs.org are. Last but not least I'll talk to Craig to see whether OLPC Jamaica will have the resources to work on a polished and print-ready version of the documentation.

Also, Dominik from OLPC Poland got in touch with me earlier this week and the folks there want to translate some parts of their manual into Polish for one of their projects. Additionally I spoke to Nkubito (one of OLPC Rwanda's lead guys) and they might also be interested in using this manual once they upgrade their ~100,000 XOs to the latest software version. Hopefully these bits of information will provide some additional motivation for all of us here to sit down and wrap up this documentation project.

So, let's get this done! :-)

FWIW I'll be online (#olpc-help on IRC, Skype, GTalk) for the next hour or so to start working on some of these tasks...

Cheers,
Christoph

--
Christoph Derndorfer

volunteer, OLPC (Austria) [www.olpc.at]
editor, OLPC News [www.olpcnews.com]
contributor, TechnikBasteln [www.technikbasteln.net]






--
Christoph Derndorfer

volunteer, OLPC (Austria) [www.olpc.at]
editor, OLPC News [www.olpcnews.com]
contributor, TechnikBasteln [www.technikbasteln.net]



_______________________________________________
Library mailing list
[hidden email]
http://lists.laptop.org/listinfo/library