<div class="gmail_quote">On Mon, Oct 31, 2011 at 1:45 AM, Sridhar Dhanapalan <span dir="ltr"><<a href="mailto:sridhar@laptop.org.au">sridhar@laptop.org.au</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<div><div></div><div class="h5">On 30 September 2011 19:51, Tabitha Roder <<a href="mailto:tabitha@tabitha.net.nz">tabitha@tabitha.net.nz</a>> wrote:<br>
> Hi<br>
><br>
> If we had a volunteer (English Native language) professional technical<br>
> writer, what writing would be of most use to OLPC or Sugar that we can point<br>
> her in the direction of? She currently works with developers to write end<br>
> user documentation.<br>
><br>
> Thanks<br>
> Tabitha - NZ volunteers<br>
<br>
<br>
</div></div>I think the most important thing is to identify and focus on the<br>
target audience - is the documentation meant for technical users, end<br>
users, teachers, children...?<br></blockquote><div><br></div><div>That's indeed the key question which we also spent some time discussing in San Francisco. The current Help activity + corresponding FlossManuals was mainly written with Give 1, Get 1 users in mind so there's definitely quite some rework that needs to be done if we're looking to cater to other audiences.</div>
<div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
We (OLPC Australia) would be happy to suggest ways in which the<br>
documentation can be improved, using our experience from working<br>
directly with teachers and communities. Our online course<br>
(<a href="http://laptop.moodle.com.au/" target="_blank">http://laptop.moodle.com.au/</a> - you can log in as a guest) might<br>
provide some inspiration.<br></blockquote><div><br></div><div>Thanks, I'll take a look:-)</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
Our Education Manager has some advice, based on her experiences with<br>
reading the publicly-available documentation:<br>
<br>
-          Make sure the Sugar and XO Floss manuals are up-to-date,<br>
easily readable and have all the necessary information.<br>
<br>
-          Externally available documentation: It’s imperative that<br>
minimal knowledge is assumed, which I think is the hardest part. Pages<br>
need to have less information rather than more, good user interfaces,<br>
lots of useful images, clear headings and language that is simple and<br>
precise. My concern with a lot of the external documentation is that<br>
it is sometimes overwhelming, difficult to navigate (both between<br>
pages and within them) and written for a technical audience rather<br>
than a basic user. Trying to target both a technical audience and a<br>
basic user in the same documentation means you are more likely to lose<br>
the basic user. Perhaps some of this documentation needs to be<br>
separate out. The main issue I see with the Wiki is that it’s<br>
difficult to navigate and find information from the menus. This isn’t,<br>
per say, the role of a technical writer, but tidying up navigation in<br>
the Wiki would make it more accessible.<br>
<br>
-          Someone to simply document the activities available<br>
(purpose of the activity, how to use it, any tips that are not easily<br>
discoverable, and what you can DO with it- exemplars of use)<br></blockquote><div><br></div><div>That point is also on our agenda: <a href="http://wiki.laptop.org/go/OLPC_SanFranciscoBayArea/OLPCSF_Community_Summit_2011/Help_Activity_Refresh#Revised_Manual_Contents">http://wiki.laptop.org/go/OLPC_SanFranciscoBayArea/OLPCSF_Community_Summit_2011/Help_Activity_Refresh#Revised_Manual_Contents</a></div>
<div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
-          There are lesson ideas and examples of practice all over<br>
the place. It would be amazing to synthesise this as much as possible,<br>
so they are not so difficult and time consuming to find, and to put<br>
them in a uniform format. I’m not sure what the best way to approach<br>
this is, but from an educational perspective, knowing not just HOW to<br>
use the XOs but WHAT to do with them is far more important. Making<br>
these ideas easily accessible, in my mind, is quite important.</blockquote><div><br></div><div>Also something that was discussed various times in San Francisco (and previously Paris). It definitely sounds like at least Australia, the Philippines, Jamaica, Madagascar - Nosy Komba, and Austria have some common needs here which I think we should expand on in a seperate thread. :-)</div>
<div><br>Cheers, </div></div>Christoph<br clear="all"><div><br></div>-- <br>Christoph Derndorfer<div><br><div>editor, OLPC News [<a href="http://www.olpcnews.com" target="_blank">www.olpcnews.com</a>]<br>volunteer, OLPC (Austria) [<a href="http://www.olpc.at" target="_blank">www.olpc.at</a>]</div>
<div><br></div><div>e-mail: <a href="mailto:christoph@derndorfer.eu" target="_blank">christoph@derndorfer.eu</a></div><div><br></div></div><br>