Difference between revisions of "Activities/Help"
(→Nice to Have Features: comment) |
(→Next Steps: comment) |
||
| Line 44: | Line 44: | ||
==Next Steps== | ==Next Steps== | ||
* Put the content of the help activity into a form that can be managed with version control so we can make different versions for the XO and SoaS and potentially let deployments customize it. - ticket {{Bug|885}} | * Put the content of the help activity into a form that can be managed with version control so we can make different versions for the XO and SoaS and potentially let deployments customize it. - ticket {{Bug|885}} | ||
| + | *: The content is currently managed on http://flossmanuals.net , which uses TWiki for editing and version history. You can go to http://en.flossmanuals.net/remix and make a Sugar 0.84 manual from the Sugar/8_4 manual items. I believe this is how someone (Sj?) loaded the HTML into http://git.sugarlabs.org/projects/help/repos/mainline/trees/master/help -- [[User:Skierpage|Skierpage]] 05:21, 26 May 2009 (UTC) | ||
==OLPC Help activity == | ==OLPC Help activity == | ||
Revision as of 00:21, 26 May 2009
Goals of the Help Activity
- Provide users with easy access to documentation and manuals
- Let people understand that Sugar is a Community Project and that we would like their help
- Invite users to join the community by asking a question
- Make visible the fact that we are real people
User Experience
I am hoping our design people will help here. I think it should be a blurb about being a community project, invitation to as a question and a link to the manual in a reader.
Specific tasks we should be sure to cover
- providing information how to setup network --> just explaning to go to F1 and to click on the essid
- function buttons F1-4 => minimal information about views world,group,me,journal/activities,
- how to set language => short cut to setting menu.
Asking a Question
We don't have a email client so we'll need people to ask a question on a web page. We'll need to explain to them that they can't use it if they are offline.
We should ask for the email address so we can answer them.
For a first iteration questions will be directed to IAEP and community members will be asked to reply. Replying with a link to an FAQ or Wiki page with an answer is to be encouraged.
If we get into any sort of dialog with the question we should invite them to subscribe to IAEP and to help the community.
Nice to Have Features
- Look up what version of Sugar they are running and point them to the appropriate manual for that version.
- If the Browse activity's home page were part of Sugar then it could link to the appropriate local file:// and/or online URLs. This home page could either be static and updated with each Sugar release; or it could dynamically built from a template as it was in the OLPC OS releases, and detect if the user has local help pages. -- Skierpage 04:53, 26 May 2009 (UTC)
Next Steps
- Put the content of the help activity into a form that can be managed with version control so we can make different versions for the XO and SoaS and potentially let deployments customize it. - ticket #885
- The content is currently managed on http://flossmanuals.net , which uses TWiki for editing and version history. You can go to http://en.flossmanuals.net/remix and make a Sugar 0.84 manual from the Sugar/8_4 manual items. I believe this is how someone (Sj?) loaded the HTML into http://git.sugarlabs.org/projects/help/repos/mainline/trees/master/help -- Skierpage 05:21, 26 May 2009 (UTC)
OLPC Help activity
OLPC:release 8.2.0 ships with the olpc:Help activity. This is a dedicated browser that shows pages describing the XO-1 laptop and its software including Sugar version 0.82. This activity is hosted at http://git.sugarlabs.org/projects/help and its material comes from community editing at http://flossmanuals.net.