Manuals: Difference between revisions
(toddk) |
(update) |
||
| Line 1: | Line 1: | ||
| ⚫ | |||
<big>A manual for Group 1</big>: a '''[[Simplified users guide]]''' is being developed. |
|||
| ⚫ | |||
<big>A manual for Group 0</big>: including people who just want to know a bit more about the laptop, is available from [https://dev.laptop.org/~sj/.library_pages/xo-guide/bundle_index.html our demo library]. (to be wikified) |
|||
== History == |
|||
| ⚫ | |||
| ⚫ | |||
There are at least four technical audiences: |
There are at least four technical audiences: |
||
| Line 28: | Line 34: | ||
bidirectional communication. |
bidirectional communication. |
||
== Startup sheets == |
=== Startup sheets === |
||
A "startup sheet" for support and maintenance should probably cover a few basic things. Sheets for a few audiences; at least groups 2 (config and troubleshooting) and 3 (distributing) above. |
A "startup sheet" for support and maintenance should probably cover a few basic things. Sheets for a few audiences; at least groups 2 (config and troubleshooting) and 3 (distributing) above. |
||
'''Basics''' |
|||
* Care and feeding of the laptop (don't leave it out in the rain, don't jump up and down on it, etc.) |
* Care and feeding of the laptop (don't leave it out in the rain, don't jump up and down on it, etc.) |
||
* First-time use (hopefully OLPC has come up with a coherent out-of-box scenario) |
* First-time use (hopefully OLPC has come up with a coherent out-of-box scenario) |
||
| Line 72: | Line 78: | ||
== Mailing List == |
== Mailing List == |
||
There is a mailing list |
There is a mailing list with weekly manual/documentation updates (the olpc library mailing list): http://mailman.laptop.org/listinfo/library |
||
http://lists.cftwinc.com/mailman/listinfo/olpc-manual |
(There is also an older mailing list at http://lists.cftwinc.com/mailman/listinfo/olpc-manual |
||
which is being phased out but has relevant archives.) |
|||
Revision as of 01:16, 4 December 2007
A manual for Group 1: a Simplified users guide is being developed.
A manual for Group 0: including people who just want to know a bit more about the laptop, is available from our demo library. (to be wikified)
History
Some early discussion about a manual with Asher Heimermann were very useful. See also contributions by Anne Gentle, Todd Kelsey and Ed Cherlin on this wiki.
Technical audiences
There are at least four technical audiences:
Group 1: Kids/novices - tutorials, self-tour, etc.
Group 2: Teachers/parents/adults/etc. (people developing/presenting content, facilitating activities, etc.) There's a lot of crossover between Group 1 and Group 2, especially in the beginning stages of the program. - tutorials, activities, etc.
Group 3: 1st-tier support (site experts, server/internet connection maintainers, etc.) - people representing the site. There's a lot of crossover between Group 2 and Group 3. - "training" program as part of rollout; needs to define roles/responsibilities/expectations as well as technical stuff.
Group 4: 2nd-tier support (server installers, troubleshooters/fixers, etc.) - people representing the organization(s) deploying the olpc program - again, "training" program as part of the rollout. Similar coverage of roles/responsibilities/expectations, though with a more technical bent than the Group 3 stuff.
There may be additional, more technical audiences (hackers, developers, etc.); because of the self-supporting nature of the program, this group would probably best be served by a wiki/listserve, etc.--open, bidirectional communication.
Startup sheets
A "startup sheet" for support and maintenance should probably cover a few basic things. Sheets for a few audiences; at least groups 2 (config and troubleshooting) and 3 (distributing) above.
Basics
- Care and feeding of the laptop (don't leave it out in the rain, don't jump up and down on it, etc.)
- First-time use (hopefully OLPC has come up with a coherent out-of-box scenario)
- How to charge up the laptop, and how to know when it needs charging. (This could be a new concept for many people in your target audience)
- How laptops link to each other in a mesh, and how they link to a server for Internet access
- How to access a browser and type in a URL--such as the support URL for OLPC.
What happens if the installer can't establish an Internet connection? How will that be handled?
Other thoughts on writing and maintaining texts
We probably need to differentiate between technical and non-technical content, and figure out a way of categorizing the two. I don't think we need to do a formal information taxonomy, but we should allow room for something like that later.
- Technical content: stuff related to olpc themselves, servers,
deployment, installation, maintenance, etc.
- Non-technical content: curriculum (lessons, activities, learning
materials, etc.)
How does this scale?
How many tiers of management/expertise/content development will be needed? This is something each "market" (education ministry, other) will be helping to define, but there probably should be some kind of management model in place to help things along and provide some kind of "template" for deployment/technical management/content development, etc.
Content management
Three main use cases for distributed and interleavable content management for different audiences:
1) documentation and tutorials [like what is discussed above] 2) textbooks and learning materials [like what big textbook orgs use] 3) interactive applications and software [standard l10n]
Language support: Will users be able to go to a multi-lingual portal and click on the language of their choice, or will each language's support be defined on the startup sheet? (Or will this be the default home page for the laptop's browser?)
Images of the inside of the Laptop, care of Ari.
Mailing List
There is a mailing list with weekly manual/documentation updates (the olpc library mailing list): http://mailman.laptop.org/listinfo/library
(There is also an older mailing list at http://lists.cftwinc.com/mailman/listinfo/olpc-manual which is being phased out but has relevant archives.)