Help Activity refresh: Difference between revisions

From OLPC
Jump to navigation Jump to search
m (added auto-gen'd list of subpages, hope that's OK.)
m (→‎Nice to have: mention out-of-date categories)
 
(103 intermediate revisions by 12 users not shown)
Line 5: Line 5:
<br>
<br>


<center><big><b><i><font size="7">[http://forum.laptop.org/chat JOIN OUR LIVE CHAT on #olpc-help!]</font></i></b></big></center>
<center><b><i><font size="6">[http://forum.laptop.org/chat JOIN OUR LIVE CHAT on #olpc-help!]</font></i></b></center>


<br>
<br>


= April 2012 Doc Sprint Schedule / Goals =
== April 2012 doc sprint schedule / goals ==
[[File:Pretask--6902765050_dd77e14114.jpg|thumb]]
[[File:Pretask--6902765050_dd77e14114.jpg|thumb]]


Line 16: Line 16:
While draft & final cuts were desired for 2011, in the end 2012 became more realistic.
While draft & final cuts were desired for 2011, in the end 2012 became more realistic.


<b>An actual in-person community doc sprint in Boston/Cambridge will take place the 5 days of Apr 6-10 to tighten/wrap this up, to be held at OLPC Foundation HQ in East Cambridge, Massachusetts. Please join us to celebrate giving back, and meet OLPC engineers if you do, over a most unique Passover and Easter!</b>
<b>An actual in-person community doc sprint will take place the 5 days of [[start date::2012-04-06|Apr 6]]-[[end date::2012-04-10|10]] at OLPC Foundation HQ in [[Has location city::East Cambridge]], Massachusetts.[[Has location country::USA| ]] Please join us to celebrate giving back, and meet OLPC engineers if you do, over a most unique Passover and Easter!</b>


Our aim is to freshen up (1) http://laptop.org/manual (2) http://wiki.sugarlabs.org/go/Activities/Help and ideally (3) a [http://www.lulu.com/content/4439260 paper book] if not (4) produce short videos for Sugar Activities that kickstart learning fast!
Our aim is to freshen up (1) http://laptop.org/manual (2) http://wiki.sugarlabs.org/go/Activities/Help and ideally (3) a [http://www.lulu.com/content/4439260 paper book] if not (4) produce short videos for Sugar Activities that kickstart learning fast!
Line 28: Line 28:
<b>Virtual Romance Ain't:</b> Please talk to [mailto:caryl@laptop.org Caryl Bigenho] and our [mailto:library@lists.laptop.org public list] if you are motivated to write a particular chapter, but cannot attend in person, thanks!! EG. We're thrilled OLPC Australia's Education Manager Tracy Richardson hopes to contribute remotely.
<b>Virtual Romance Ain't:</b> Please talk to [mailto:caryl@laptop.org Caryl Bigenho] and our [mailto:library@lists.laptop.org public list] if you are motivated to write a particular chapter, but cannot attend in person, thanks!! EG. We're thrilled OLPC Australia's Education Manager Tracy Richardson hopes to contribute remotely.


Our work should center on [[Releases|Release 11.3.1]] especially, expected early in 2012, running on the XO-1, XO-1.5 and XO-1.75. Claudia Urrea suggests we avoid complex activities like Etoys, Scratch etc -- instead mixing up 2008's Activity list beyond the [http://laptop.org/manual classic 4 {Record, Browse, Write, Turtle Art}] to consider newly popular ones like FotoToon.
Our work should center on [[Releases|Release 11.3.x]] especially (Build 883 / Sugar 0.94) running on the XO-1, XO-1.5 and XO-1.75. Claudia Urrea suggests we avoid complex activities like Etoys, Scratch etc -- instead mixing up 2008's Activity list beyond the [http://laptop.org/manual classic 4 {Record, Browse, Write, Turtle Art}] to consider newly popular ones like FotoToon.


Beyond core book topics (eg. popular Sugar Activities and XO-1, XO-1.5, XO-1.75 hardware etc) most of us would be thrilled to see tight chapters on Gnome, Learning Realities/Lesson Plans/Stories, Deployment, School Server/XS, Community Leadership, SoaS, XO-3 dreams etc -- if a suitably talented volunteer author emerges, to take charge of any such chapter?
Beyond core book topics (eg. popular Sugar Activities and XO-1, XO-1.5, XO-1.75 hardware etc) most of us would be thrilled to see tight chapters on Gnome, Learning Realities/Lesson Plans/Stories, Deployment, School Server/XS, Community Leadership, SoaS, XO-3 dreams etc -- if a suitably talented volunteer author emerges, to take charge of any such chapter?
Line 49: Line 49:
Huge thanks to Seth Woodworth, Caryl Bigenho, Christoph Derndorfer, Pablo Flores & others continuing to push us steadily forward!
Huge thanks to Seth Woodworth, Caryl Bigenho, Christoph Derndorfer, Pablo Flores & others continuing to push us steadily forward!


== Video Tutorials: Apr 3-5 ==
=== Video tutorials: Apr 3-5 ===
BONUS PREGAME: Video Tutorials "Incubator" Presprint for our favorite Sugar activities & XO tips/tricks, thanks to the very hard work of Bill Stelzer, Mark Battley, Laura de Reynal, Christoph Derndorfer, Caryl Bigenho, Sameer Verma, Craig Perue and a growing list of talented mediamakers.
BONUS PREGAME: Video Tutorials "Incubator" Presprint for our favorite Sugar activities & XO tips/tricks, thanks to the very hard work of Bill Stelzer, Mark Battley, Laura de Reynal, Christoph Derndorfer, Caryl Bigenho, Sameer Verma, Craig Perue and a growing list of talented mediamakers.
Line 55: Line 55:
Expected Start Time: 9AM Tuesday April 3rd @ OLPC Foundation HQ in East Cambridge. [mailto:holt@laptop.org RSVP] if you're interested in showcasing a particular Sugar Activity. Specific screencast/video ideas & experience most welcome. Do share your vision on the [http://lists.laptop.org/listinfo/library library@lists.laptop.org mailing list] too!
Expected Start Time: 9AM Tuesday April 3rd @ OLPC Foundation HQ in East Cambridge. [mailto:holt@laptop.org RSVP] if you're interested in showcasing a particular Sugar Activity. Specific screencast/video ideas & experience most welcome. Do share your vision on the [http://lists.laptop.org/listinfo/library library@lists.laptop.org mailing list] too!


== Doc Sprint: Apr 5/6-10 ==
=== Doc Sprint: Apr 5/6-10 ===


{|
{|
Line 71: Line 71:


FRI Apr 6 - 10:00am start @ OLPC HQ. Claudia Urrea can help with TOC, Activity recommendations, etc<br>
FRI Apr 6 - 10:00am start @ OLPC HQ. Claudia Urrea can help with TOC, Activity recommendations, etc<br>
10:00-12:00 - Getting organized: goals, tools, workflow, work separation, styleguides, etc.<br>
10:00-1:00 - OLPC HQ: Getting organized - goals, tools, workflow, work separation, styleguides, etc.<br>
12:00-5:00 - Work @ OLPC HQ!
1:00-2:00 - Sunny Lunch on Charles River!<br>
2:00-5:00 - OLPC HQ: Real Work!<br>
5:30-9:30 - [http://www.mfa.org/programs/special-event/mfa-first-fridays DJ Deja @ Museum of Fine Art]
5:30-9:30 - [http://www.mfa.org/programs/special-event/mfa-first-fridays DJ Deja @ Museum of Fine Art] (DETAILS TBA)


|width="4%" valign="top"|
|width="4%" valign="top"|
|width="48%" valign="top"|
|width="48%" valign="top"|
SAT Apr 7 - Passover but working!<br>
SAT Apr 7 - Passover but working!<br>
10:00-5:00 - Work @ OLPC HQ!<br>
10:00-1:00 - Work @ OLPC HQ!<br>
1:00-2:00 - <!--http://void.printf.net/pipermail/social/--> BRING LUNCH/DRINK OFFERINGS to <b>[http://wiki.mako.cc/Ohanami Japanese Blossom Fest on Charles River]</b> (urban garden adventure at last!)<br>
5:00pm? - 3 Frisbee Hunt right outside OLPC bldg!
2:00-5:00 - Work @ OLPC HQ!


SUN Apr 8 - Easter: Nancie Severs arrives<br>
SUN Apr 8 - Easter: Nancie Severs arrives<br>
10:00 - Work @ OLPC HQ!<br>
10:00 - Work @ OLPC HQ!<br>
11:00 - Separate [[ALEARN Network]] call<br>
11:00 - Separate [[ALEARN Network]] call<br>
1:00-2:00 - SPECIAL FRISBEE LUNCH right outside OLPC HQ!<br>
2:00? - [http://void.printf.net/pipermail/social/ Japanese Blossom Fest on Charles River] (urban garden adventure at last!)<br>
2:00-5:00 - Work @ OLPC HQ!<br>
9:30PM Grendel's Den dinner/drinks in Harvard Sq with Mako!
9:30 - Grendel's Den dinner/drinks in Harvard Sq with Mako+Mika!


MON Apr 9 - Paul Fox arrives<br>
MON Apr 9 - Paul Fox arrives<br>
10:00-5:00 - Work @ OLPC HQ!<br>
10:00-3:45 - Work @ OLPC HQ!<br>
3:30 - Frisbee/Soccer Game @ Charles Park in East Cambridge on the river, betw Binney St & Rogers St (Chris Ball, Laura de Reynal, Adam Holt)<br>
Someone pick a *GREAT* dinner location!
8:00 - Someone pick a *GREAT* dinner location! (TENTATIVE)


TUE Apr 10 - All Day Final Crunch!
TUE Apr 10 - All Day Final Crunch!<br>
10:00-5:00 - Work @ OLPC HQ!
10:00-5:00 - Work @ OLPC HQ!
|}
|}


==People==
===People===


<b>Add your name! Include 2 words about the "Chapter" you're contributing!</b>
<b>Add your name! Include 2 words about the "Chapter" you're contributing!</b>
Line 106: Line 110:
* Bill Stelzer (remote?)
* Bill Stelzer (remote?)
* Caryl Bigenho (remote from SoCal, already added a Tam Tam Chapter. It is ready for testing!)
* Caryl Bigenho (remote from SoCal, already added a Tam Tam Chapter. It is ready for testing!)
* Cherry Withers (Browse, Addition of Etoys Chapter -- Remote from Philippines)
* Cherry Withers (Browse, Addition of Etoys Chapter -- Remote from California)
* Chris Ball
* Chris Ball
* Chris Leonard (translation recommendations)
* Chris Leonard (translation recommendations)
Line 119: Line 123:
* Ev Batey (Remote from SoCal)
* Ev Batey (Remote from SoCal)
* George Hunt (Apr 7-9/10)
* George Hunt (Apr 7-9/10)
* Harriet Vidyasagar Apr 6-9 (Tam Tam) Deployment Tool kits.
* Harriet Vidyasagar Apr 6 remote (7-9) (Tam Tam) Deployment Tool kits.
* Jennifer Martino & Canadian colleague (Apr 6-9/10, kidnapped to Nicaragua!)
* Jennifer Martino & Canadian colleague (Apr 6-9/10, kidnapped to Nicaragua!)
* Ken Knight (Remote from SoCal)
* Ken Knight (Remote from SoCal)
Line 139: Line 143:
* Robert Fadel (Sugar Labs' finance officer)
* Robert Fadel (Sugar Labs' finance officer)
* Saadia Baloch
* Saadia Baloch
* Sameer Verma (Apr 5-9)
* Sameer Verma (Apr 5-9. XS and Hardware)
* Sandra Thaxter (Turtle Art AND I'll help MarkB on Memorize and Maze..)
* Sandra Thaxter (Turtle Art AND I'll help MarkB on Memorize and Maze..)
* [[User:Sethwoodworth|Seth Woodworth]] (Apr 6-10, creating TOC/coordination page!)
* [[User:Sethwoodworth|Seth Woodworth]] (Apr 6-10, creating TOC/coordination page!)
Line 146: Line 150:
* Tony Anderson (remote from Rwanda/Nepal? Get started, Network, Interface)
* Tony Anderson (remote from Rwanda/Nepal? Get started, Network, Interface)
* Tony Forster (Remote from Melbourne Austrailia)
* Tony Forster (Remote from Melbourne Austrailia)
* Walter Bender
* Walter Bender (Portfolio, Turtle Art)
* <s>[[User:Yamaplos|Yama Ploskonka]] sorting out if I'm travelling South in those dates, so this is a 'likely', though I'd wish to see y'all agin</s> Sorry, won't be possible <span style="background:#FFFFFF; padding:1px; margin-left:20px; font-size:75%;">[[Image:red.png]][[User:Yamaplos|<span style="color:#000091;cursor:" title="Sur volunteer, OLE, Bolivia, Uruguay"> Yamaplos </span>]]</span><font size="small"> 19:15, 22 March 2012 (UTC)
* <s>[[User:Yamaplos|Yama Ploskonka]] sorting out if I'm travelling South in those dates, so this is a 'likely', though I'd wish to see y'all agin</s> Sorry, won't be possible <span style="background:#FFFFFF; padding:1px; margin-left:20px; font-size:75%;">[[Image:red.png]][[User:Yamaplos|<span style="color:#000091;cursor:" title="Sur volunteer, OLE, Bolivia, Uruguay"> Yamaplos </span>]]</span><font size="small"> 19:15, 22 March 2012 (UTC)
|}
|}


= Current Help Activity Contents =
== Table of Contents ==


NEW Table of Contents: [[Help_Activity_refresh/TOC]]
You will notice some sections below with (???) after them. We are still looking for volunteers to work on those sections. If you would like to join with one of the other volunteers who is already working on one of the sections, please add your name and contact the person so you can coordinate your work!

<s>ChristophD & CarylB are explaining live in person & over Skype Noon Fri April 6.</s> Done.

== Pre-2012 Help Activity contents ==

From http://laptop.org/manual especially. You will notice some sections below with (???) after them. We are still looking for volunteers to work on those sections. If you would like to join with one of the other volunteers who is already working on one of the sections, please add your name and contact the person so you can coordinate your work!
*Introduction (Introduction, About OLPC, What is Sugar, How to Volunteer) (Christoph Derndorfer & Adam Holt, Sandra Thaxter)
*Introduction (Introduction, About OLPC, What is Sugar, How to Volunteer) (Christoph Derndorfer & Adam Holt, Sandra Thaxter)
Line 166: Line 176:
*Appendices (Keyboard Shortcuts, Personalizing Sugar, Glossary, Getting Support, Credits) (Sandra Thaxter???)
*Appendices (Keyboard Shortcuts, Personalizing Sugar, Glossary, Getting Support, Credits) (Sandra Thaxter???)


= Revised Manual Contents =
== Revised manual contents ==
<font size="4">
: See Latest: [[Help Activity refresh/TOC]]
</font>
This section lists the sections and chapters we are working on. It will be changed from time to time as we revise and add. If you add a section or chapter, be sure you have someone to work on it! Also, please add it and the name of the person (or persons) who will be working on it to the section below called "Suggestions for Additional Chapters."
This section lists the sections and chapters we are working on. It will be changed from time to time as we revise and add. If you add a section or chapter, be sure you have someone to work on it! Also, please add it and the name of the person (or persons) who will be working on it to the section below called "Suggestions for Additional Chapters."


Line 176: Line 189:
{|
{|
|width="48%" valign="top"|
|width="48%" valign="top"|
== Copy of Current User Manual ==
=== Copy of current User Manual ===


A copy of the current User Manual as it appears in the Help Activity can be found at:
A copy of the current User Manual as it appears in the Help Activity can be found at:
Line 186: Line 199:
If you are working in Windows or Mac OSX you will find instructions for downloading, viewing and editing this in the "Special For..... " notes below. Instructions for Linux users are coming.
If you are working in Windows or Mac OSX you will find instructions for downloading, viewing and editing this in the "Special For..... " notes below. Instructions for Linux users are coming.


== Chapters and Resources ==
=== Chapters and resources ===
* [http://wiki.sugarlabs.org/go/0.94/Notes Sugar 0.94 release notes]
* [http://wiki.sugarlabs.org/go/0.94/Notes Sugar 0.94 release notes]
* [http://wiki.laptop.org/go/11.3.0 OLPC OS 11.3.0 release notes]
* [[11.3.0|OLPC OS 11.3.0]] [[Release_notes/11.3.0|Release Notes]]


List of manuals and chapters:
List of OLD manual chapters:
* XO manual (Introduction, Getting Started, Battery, Network, Support, Appendices): http://booki.flossmanuals.net/xo/_draft/
* XO manual (Introduction, Getting Started, Battery, Network, Support, Appendices): http://booki.flossmanuals.net/xo/_draft/
* Browse Activity Chapter: http://booki.flossmanuals.net/browse/_draft/_v/1.0/
* Browse Activity Chapter: http://booki.flossmanuals.net/browse/_draft/_v/1.0/
Line 204: Line 217:
|width="4%" valign="top"|
|width="4%" valign="top"|
|width="48%" valign="top"|
|width="48%" valign="top"|

== Existing draft chapters ==
=== Existing draft chapters ===
Existing manuals that are incomplete or not added to Help Activity:
Existing manuals that are incomplete or not added to Help Activity:
* Chat: http://booki.flossmanuals.net/chat/_draft/
* Chat: http://booki.flossmanuals.net/chat/_draft/
Line 217: Line 231:
* Terminal: http://booki.flossmanuals.net/terminal/_draft/
* Terminal: http://booki.flossmanuals.net/terminal/_draft/


== Suggestions for new chapters ==
=== Suggestions for new chapters ===


* Localization (Registering, Forking, Translating, Adding and Deleting Chapters, Changing Graphics and Images)
* Localization (Registering, Forking, Translating, Adding and Deleting Chapters, Changing Graphics and Images)
Line 229: Line 243:
|}
|}


= How to Participate =
== How to participate ==

If you plan to participate in the XO Users Manual refresh, either at the mini book sprint on the 21st or remotely before or after that, there are some things you should do ahead of time...
Read the [[#Style Guide]] below!

==== Start editing here ====

http://wiki.laptop.org/go/Help_Activity_refresh/TOC

=== Screenshots ===

* '''Alt + 1''' key combination (on XO keyboards) or '''PrnScn''' with attached keyboards
* post-processing with standard laptops and your tools of choice ([http://www.getpaint.net/ Paint.Net] (Windows) for me)
* bring your XOs loaded with the latest [http://wiki.laptop.org/go/11.3.0 11.3.0] development builds since that's the easiest way to get Sugar 0.94
* for setting up more complex scenes you can also use ''ImageMagick'' in the Terminal Activity: ''sleep 10; import -window root MyScreenshot1.png'' will give you 10 seconds to set up a scene, then take a screenshot of the full screen, and save it as MyScreenshot1.png (which is not accessible from the Journal so you will need to copy it over to a USB drive via the Terminal's ''cp'' command or using GNOME)

<!--* Consider investigating whether using the [http://wiki.laptop.org/go/Sugar/Quick_screenshot_hack advanced screenshot hack] is a viable alternative-->
<!--If you plan to participate in the XO Users Manual refresh, either at the mini book sprint on the 21st or remotely before or after that, there are some things you should do ahead of time...


*Register an account on FLOSS Manuals' "Booki" site:
*Register an account on FLOSS Manuals' "Booki" site:
Line 250: Line 279:
A click on the "Manuals" tab will show a list of all the manuals members of the group are working on. You can click on each one and see what is there. Some are very complete, others are only skeletons. Our manual is currently at the bottom of the list: "XO Users Manual (Rev 2011)." Currently, all of the chapters are "hidden" and waiting to be written, revised, and/or edited. If you click on "Edit" you will be able to see them at the bottom of the page. Please do not do any writing or editing until you have read and understand everything in the Booki Users Manual: http://en.flossmanuals.net/Booki-User-Guide/
A click on the "Manuals" tab will show a list of all the manuals members of the group are working on. You can click on each one and see what is there. Some are very complete, others are only skeletons. Our manual is currently at the bottom of the list: "XO Users Manual (Rev 2011)." Currently, all of the chapters are "hidden" and waiting to be written, revised, and/or edited. If you click on "Edit" you will be able to see them at the bottom of the page. Please do not do any writing or editing until you have read and understand everything in the Booki Users Manual: http://en.flossmanuals.net/Booki-User-Guide/


The members tab will give you a list of the people who have signed up for the group. If you would like to add a photo and a little blurb about yourself to the your listing, the place to do that is the "My Settings" section (find it listed on the second menu on the top left).
The members tab will give you a list of the people who have signed up for the group. If you would like to add a photo and a little blurb about yourself to the your listing, the place to do that is the "My Settings" section (find it listed on the second menu on the top left).-->
<!--http://booki.flossmanuals.net/xo-users-manual-rev-2011/_edit/


Note: this is a corrected link. Sign in first, then go to "WRITE." The CHAPTERS are at the bottom of the page as works-in-progress. The SECTIONS, above the CHAPTERS are currently empty. READ does not allow public access to the unfinished/unpublished chapters. You must sign in and go to WRITE to see what we are working on and to participate in writing and editing. Eventually, when the CHAPTERS are completed, they will be moved up into the SECTIONS. At that time they will be viewable by the general public.
== Procedures on Porting/Assembling the Manual into Help Activity ==


You can also find this link at: http://booki.flossmanuals.net/groups/one-laptop-per-childsugar-labs/ It is the last (newest) manual... at the bottom of the list.-->
Information still needed for this section


=== Procedures on porting/assembling the manual into Help Activity ===
=== Start editing here ===


Information still needed for this section
http://booki.flossmanuals.net/xo-users-manual-rev-2011/_edit/


====Special for Windows users====
Note: this is a corrected link. Sign in first, then go to "WRITE." The CHAPTERS are at the bottom of the page as works-in-progress. The SECTIONS, above the CHAPTERS are currently empty. READ does not allow public access to the unfinished/unpublished chapters. You must sign in and go to WRITE to see what we are working on and to participate in writing and editing. Eventually, when the CHAPTERS are completed, they will be moved up into the SECTIONS. At that time they will be viewable by the general public.


LEGACY INSTRUCTIONS FOR BOOKI USERS ONLY!
You can also find this link at: http://booki.flossmanuals.net/groups/one-laptop-per-childsugar-labs/ It is the last (newest) manual... at the bottom of the list.


===Special for Windows Users===
(Contributed byTony Forster in Melbourne Australia)
(Contributed byTony Forster in Melbourne Australia)


Line 282: Line 311:
The htm files are best edited with something like Frontpage but you can use Notepad or Wordpad if you like working with html
The htm files are best edited with something like Frontpage but you can use Notepad or Wordpad if you like working with html


===Special for Mac OS-X Users===
====Special for Mac OS X users====

LEGACY INSTRUCTIONS FOR BOOKI USERS ONLY!

(Contributed by Caryl Bigenho with help from Tony Forster)
(Contributed by Caryl Bigenho with help from Tony Forster)
* Control-click on :
* Control-click on :
Line 306: Line 338:
If you have a capable text editor such as TextWrangler ( http://www.barebones.com/products/textwrangler/download.html ) you will be able to see and edit the file in html.
If you have a capable text editor such as TextWrangler ( http://www.barebones.com/products/textwrangler/download.html ) you will be able to see and edit the file in html.


== Screenshots ==
==Tasks==


=== Ideas and unassigned tasks ===
* '''Alt + 1''' key combination (on XO keyboards) or '''PrnScn''' with attached keyboards
* post-processing with standard laptops and your tools of choice ([http://www.getpaint.net/ Paint.Net] (Windows) for me)
* bring your XOs loaded with the latest [http://wiki.laptop.org/go/11.3.0 11.3.0] development builds since that's the easiest way to get Sugar 0.94
* investigate whether using the [http://wiki.laptop.org/go/Sugar/Quick_screenshot_hack advanced screenshot hack] is a viable alternative


=Tasks=

== Ideas and unassigned tasks ==


* keep localization in mind (see the corresponding thread from early October on Sugar-Devel, etc.
* keep localization in mind (see the corresponding thread from early October on Sugar-Devel, etc.
Line 322: Line 346:
* use the Activity descriptions in other places such as [http://activities.sugarlabs.org ASLO], [http://git.sugarlabs.org/ git], etc.
* use the Activity descriptions in other places such as [http://activities.sugarlabs.org ASLO], [http://git.sugarlabs.org/ git], etc.


== Hands-on testing of chapters with XOs ==
=== Hands-on testing of chapters with XOs ===
Want to make sure chapters are correct and easy to understand
Want to make sure chapters are correct and easy to understand


=== Follow up needed ===
= Style Guide =

* with SJ: pdf and openzim export from MediaWiki

== Style Guide ==

<font size=4>
: Start by reviewing [[Help_Activity_refresh/Chapter/TamTam|Caryl's Model Chapter!]]
</font>


Some aspects of style should be enforced via CSS. Others require that writers, editors, artists and other be aware of how we have agreed things should be done, such as not translating "Sugar", consistent capitalization, consistent image formats, and the like.
Some aspects of style should be enforced via CSS. Others require that writers, editors, artists and other be aware of how we have agreed things should be done, such as not translating "Sugar", consistent capitalization, consistent image formats, and the like.


See the [[OLPC:Style guide|OLPC Wiki Style Guide]] and [http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Style_Guide Sugar Labs' Style Guide] as starting point conventions.
== Images ==


==== Capitalization ====
* screenshots: resized to a max. width of 800px
* icons: use of original icon size (55px * 55px)
* TBD: standard for annotations, highlights in images, etc.


* '''A'''ctivity / '''A'''ctivities
== Page Locations ==
* ''OLPC'' and ''Sugar'' are not translated
* Lots of Capitalized Words

=== Text ===

* suggestions: 1200~1500 words
* Consider using vocabulary that's also present in the .pot files to speed up / facilitate translation
* Consider using the translation memory function in lokalize to make this information readily accessible to localizers and translators.
* Consider using lokalize offline when translating, and uploading finished draft chapters.

=== Images ===

* Image upload: You have to be logged in and then click the [http://wiki.laptop.org/go/Special:Upload UPLOAD FILE] link in the Toolbox section on the left-hand side menu (please also note the [http://wiki.laptop.org/go/Special:MultipleUpload multiple upload page] for uploading up to 5 files at once).
** when you upload, be sure in the description to give the Activity version and software version:<br /> <tt>''Activity Name-NN'', OS 11.3.0 / build 883 / Sugar 0.94.1</tt> along with what you're capturing
* For an image placeholder, either:
** type the exact words <tt>'''MISSING IMAGE'''</tt>
** add the wiki markup <tt><nowiki>[[</nowiki>File:Screenshot wanted.png|800px|''ActivityName'' screenshot]]</tt> or <tt><nowiki>[[</nowiki>File:Toolbar wanted.png|800px|''ActivityName'' toolbar]]</tt> to put a placeholder image in the wiki page.

==== Must-Do ====

* number: max. 4~6 images per page / chapter
* sizes:
** screenshots: resized to a max. width of 800px
** icons: 55px * 55px, activities' SVG icons default to this
* naming-conventions:
** screenshot: ''Chapter[''-''Feature]''-''more_description'' OR ''Activity_Name''-''more_description'' (-es on end if in Spanish, -fr for French, etc.)
** icons: ''Chapter[''-''Feature]''-''more_description'' OR ''Activity_Name''-''more_description''-icon.png or .svg
*** {{SERVERNAME}} already has most Activities' icons, usually named Activity-''activityname''.svg , see [{{fullurl:Special:ListFiles|ilsearch=Activity-}} Special:ListFiles]. Many are in [[:Category:SVG]]. Most icons are years old but most activity icons haven't changed.
* Annotations, Highlights:
** Font: Arial
** Font size: 10pt
** Colour: Open Office "Light Red" (#ff0000, rgb(255,0,0))
**: (note XO laptops do not have the Arial font, so this prevents exporting as SVG)
** Internationalization: if possible please keep text annotations in a separate layer of your images so they can be switched out easily. You can and should upload the master image or drawing file to the wiki as well as the resulting png image.

==== Nice to have ====

* [[Media:OOD 800px template test.odg|OpenOffice Draw template for annotations]] and [[Help_Activity_Refresh/Image Template Guide|associated how-to guide]] (by Mike Lee)
* categorization: Use these existing categories: [[:Category:Screenshots_by_type]], [[:Category:Screenshots_by_activity]] (with a subcategory for each activity), [[:Category:Screenshots_of_Sugar]].
** If you see an out-of-date screenshot in these categories, change its category to one of the out-of-date categories, such as [[:Category:Old activity screenshots]] or [[:Category:Release 8.2]]
** wiki.sugarlabs.org doesn't seem to have any standards or categories for its hundreds of images, see http://wiki.sugarlabs.org/go/Special:AllPages/File:
* Another useful link http://wiki.laptop.org/go/Special:ListFiles
* If there's an out-of-date screenshot with the same name, just upload the new version over it. --> only makes sense within context of this refresh, overwriting other images is not recommended as it might lead to confusions in the context of where they're being used right now (IMHO) [[User:ChristophD|ChristophD]] 16:07, 7 April 2012 (UTC)

=== Chapter locations ===


# Hardware: on wiki.laptop.org
# Hardware: on wiki.laptop.org
#* subpages of the [[/Chapter]] subsection of this, e.g. [[Help Activity refresh/Chapter/Keyboard]]
# Core Sugar: on wiki.sugarlabs.org
# Core Sugar: on wiki.sugarlabs.org
#* where?
# Activities: on wiki.sugarlabs.org (Activity related learning-focused content can be split between w.l.o and s.l.o with good links)
# Activities: on wiki.sugarlabs.org (Activity related learning-focused content can be split between w.l.o and s.l.o with good links)
#* Recommendation to work here: http://wiki.laptop.org/go/Help_Activity_refresh/Chapter/TamTam (EG. GrannieB!)
#* w.s.o can use wiki links to <nowiki>[[olpc:Help Activity refresh/content/Battery]]</nowiki>, w.l.o should be able to link to <tt>[[sugar:somewhere/content/Title</tt>, but there's a bug (<trac>9285</trac>).
#* Follow Walter Bender's examples here where possible:
#**http://wiki.sugarlabs.org/go/Activities/XoEditor
#**http://wiki.sugarlabs.org/go/Activities/Portfolio


== Structure ==
=== Structure ===


==== Suggested Activity Chapter Structure ====
* Activity-related pages should include this tag <pre>[[Category:Activity]]</pre>
TBD but possibly something similar to http://wiki.sugarlabs.org/go/Activities/Portfolio


'''updated suggestion (by Walter)'''
== Text ==


* About <ACTIVITY> (add '''Activity version''' which you are referring to)
* Consider using vocabulary that's also present in the .pot files to speed up / facilitate translation
** activity's SVG icon
* Consider using the translation memory function in lokalize to make this information readily accessible to localizers and translators.
* Where to get <ACTIVITY>
* Consider using lokalize offline when translating, and uploading finished draft chapters.
<s>* Starting <ACTIVITY></s> -> simply include the icon on top of page (like on the [http://wiki.sugarlabs.org/go/Activities/Portfolio Portfolio] page)
TBD
* Using <ACTIVITY>
** The Toolbars
** <ACTIVITY-SPECIFIC DESCRIPTIONS>
* Learning with <ACTIVITY> (-> education context, basically the same as "A word to educators")
* Extending <ACTIVITY> (focused on expanding the education use: scaffolding, connections to other activities, curriculum arcs)
* Modifying <ACTIVITY> (focused on modification of software)
* Where to report problems
** A word to developers
* Credits
Paste this into the edit window for any new page you are just starting, and replace the *s with the Activity name:


<nowiki>==About *==</nowiki>
=== Standards ===


<nowiki>[[file:activity-*.svg]]</nowiki>
* '''A'''ctivity / '''A'''ctivities

* ''OLPC'' and ''Sugar'' are not translated
(add '''Activity version''' which you are referring to)

<nowiki>==Where to get *==</nowiki>


<nowiki>==Using *==</nowiki>


<nowiki>===The Toolbars===</nowiki>


<nowiki>===<Activity-specific descriptions>===</nowiki>


<nowiki>==Learning with *==</nowiki>


<nowiki>==Extending *==</nowiki>


<nowiki>==Modifying *==</nowiki>


<nowiki>==Where to report problems==</nowiki>


<nowiki>==Credits==</nowiki>


<nowiki>== *==</nowiki>


===== Previous ideas (--> Deprecated) =====

* About <ACTIVITY>
* Where to get <ACTIVITY>
* Starting <ACTIVITY>
* Using <ACTIVITY>
** The Toolbars
** <ACTIVITY-SPECIFIC DESCRIPTIONS>
* Applying <ACTIVITY> (-> education context, basically the same as "A word to educators")
* Extending <ACTIVITY> (basically the same as "Suggestions for modification" / "Suggestions for enhancements")
* Where to report problems
* A word to developers
* Credits

'''or this suggestion, more child centric? (by Tony Forster)'''

* About <ACTIVITY>
* Starting <ACTIVITY>
* Using <ACTIVITY>
** The Toolbars
** <ACTIVITY-SPECIFIC DESCRIPTIONS>
* Applying <ACTIVITY> (-> education context, basically the same as "A word to educators")
* Extending <ACTIVITY> (basically the same as "Suggestions for modification" / "Suggestions for enhancements")
* Credits

==== Nice to Have ====

* Activity-related pages should include this tag <code><nowiki>[[Category:Activities|TITLE]]</nowiki></code> (The TITLE would be the particular Activity Name, which will be used to sort the [[:Category:Activities]] page.) Would this be better??<code><nowiki>[[Category:Activity documentation|TITLE]]</nowiki></code>.
* Possibly use an additional tag like [[:Category:Help Activity content]] across pages and images, maybe include a version 11.3.0.

=== Wiki markup tips ===
Use an HTML comment for notes and ToDos, e.g.
&lt;-- ToDo: re-take screenshot with XO buddy list --&gt;

To link from one chapter to another you can use two dots and a slash (../''ChapterName''), e.g. <tt><nowiki>[[../The_Frame|Frame]]</nowiki></tt>

=== Subpages of {{FULLPAGENAME}}===
For only the chapters in order, see the [[/TOC|Table of Contents]]


== Subpages of {{FULLPAGENAME}}==
{{Special:PrefixIndex/{{FULLPAGENAME}}/}}
{{Special:PrefixIndex/{{FULLPAGENAME}}/}}


[[category:documentation]]
[[category:documentation]]
[[category:meetings]]

Latest revision as of 09:10, 13 April 2012


Pencil.png NOTE: The contents of this page are not set in stone, and are subject to change!

This page is a draft in active flux ...
Please leave suggestions on the talk page.

Pencil.png


Ideas for the refresh of OLPC/Sugar's Help Activity, associated web/paper manual and possibly new vid tutorials! Bookmark http://j.mp/xomanual to help!


JOIN OUR LIVE CHAT on #olpc-help!


April 2012 doc sprint schedule / goals

Pretask--6902765050 dd77e14114.jpg

Initial planning occurred Friday October 21st, 2011 from 10AM to 4 PM outside the Kleider home in Bolinas, California, with almost 10 people present.

While draft & final cuts were desired for 2011, in the end 2012 became more realistic.

An actual in-person community doc sprint will take place the 5 days of Apr 6-10 at OLPC Foundation HQ in Has location city::East Cambridge, Massachusetts. Please join us to celebrate giving back, and meet OLPC engineers if you do, over a most unique Passover and Easter!

Our aim is to freshen up (1) http://laptop.org/manual (2) http://wiki.sugarlabs.org/go/Activities/Help and ideally (3) a paper book if not (4) produce short videos for Sugar Activities that kickstart learning fast!

Bonus Pregame: Apr 3-5 Video Tutorials "Incubator" Presprint for our favorite Sugar activities, thanks to Bill Stelzer, Mark Battley, Laura de Reynal, Christoph Derndorfer, Caryl Bigenho, Sameer Verma, Craig Perue and a growing list of talented mediamakers. Detail emerging below.

Experienced OLPC implementation groups from Kenya, Jamaica and Australia have confirmed their desire to attend; we hope others will RSVP too. Deployment knowledge is warmly welcomed! Mike Dawson, Tim Falconer, Tony Anderson, Chris Lowe etc etc etc -- do give us a ring!

Expected in person -- details emerging below: Sameer Verma, Mike Lee, Walter Bender, Claudia Urrea, Richard Smith, Christoph Derndorfer, Reuben Caron, SJ Klein, Mark Battley, Jennifer Martino, Paul Fox, George Hunt, Chris Ball, Nancie Severs, CScott Ananian, Craig Perue, Saadia Baloch, Bill Stelzer, Bernie Innocenti, Dogi Unterhauser, Laura de Reynal, Adam Holt, etc -- even Sugar Labs' new finance officer Robert Fadel, and Pablo Flores if we are lucky! Apologies attendance will likely be limited due to our facility's limited capacity.

Virtual Romance Ain't: Please talk to Caryl Bigenho and our public list if you are motivated to write a particular chapter, but cannot attend in person, thanks!! EG. We're thrilled OLPC Australia's Education Manager Tracy Richardson hopes to contribute remotely.

Our work should center on Release 11.3.x especially (Build 883 / Sugar 0.94) running on the XO-1, XO-1.5 and XO-1.75. Claudia Urrea suggests we avoid complex activities like Etoys, Scratch etc -- instead mixing up 2008's Activity list beyond the classic 4 {Record, Browse, Write, Turtle Art} to consider newly popular ones like FotoToon.

Beyond core book topics (eg. popular Sugar Activities and XO-1, XO-1.5, XO-1.75 hardware etc) most of us would be thrilled to see tight chapters on Gnome, Learning Realities/Lesson Plans/Stories, Deployment, School Server/XS, Community Leadership, SoaS, XO-3 dreams etc -- if a suitably talented volunteer author emerges, to take charge of any such chapter?

Our English screenshots will of course complicate translation, but Pablo Flores/Walter Bender have hope, using SVG (eg. during an Uruguayan translation jam @ eduJAM! May 7-12, 2012?) George Hunt has great ideas to automate screenshots, possibly using gtk-gnome regression tools.

We will have an absolute blast. Active contribution will be required, as we are already approaching capacity. All logistics/housing/travel must be self-organized and self-paid. Bernie's Google-funded McMansion only fits so many sleeping bags on the floor, sorry ;)

holt@laptop.org and other locals will provide Cambridge-area discount lodging tips where they can, if you're a genuine contributor.

Documentation design will be centered around the library@lists.laptop.org mailing list and live chat irc channels #olpc-help and #sugar.

Activity Central may provide a small amount of sponsorship to the effort, strictly at their discretion.

Tom Clancy fans ("Collaboration on a book is the ultimate unnatural act") please see how this has worked in the past:

http://booki.flossmanuals.net/a-webpage-is-a-book/what-is-a-book-sprint/
http://www.booksprints.net/book-sprint-methodology/

Huge thanks to Seth Woodworth, Caryl Bigenho, Christoph Derndorfer, Pablo Flores & others continuing to push us steadily forward!

Video tutorials: Apr 3-5

BONUS PREGAME: Video Tutorials "Incubator" Presprint for our favorite Sugar activities & XO tips/tricks, thanks to the very hard work of Bill Stelzer, Mark Battley, Laura de Reynal, Christoph Derndorfer, Caryl Bigenho, Sameer Verma, Craig Perue and a growing list of talented mediamakers.

Expected Start Time: 9AM Tuesday April 3rd @ OLPC Foundation HQ in East Cambridge. RSVP if you're interested in showcasing a particular Sugar Activity. Specific screencast/video ideas & experience most welcome. Do share your vision on the library@lists.laptop.org mailing list too!

Doc Sprint: Apr 5/6-10

WED Apr 4 - 7:00pm IRC Planning Meeting on #olpc-help @ irc.freenode.net (http://forum.laptop.org)
NEW: TRANSCRIPT POSTED HERE!

THU Apr 5 - Pre-planning
10:00 doors open @ OLPC HQ
1:00 LUNCH @ 2nd Street Cafe, 89 2nd St. http://2ndStCafe.com/fullmenu http://yelp.com/biz/2nd-street-cafe-cambridge
4:00 soccer @ Sennott Park on Broadway by Prospect St in Central Cambridge (TENTATIVE)
5:00pm - Adapting Journalism to the Web @ MIT Media Lab Rm 633. With Christoph D, Laura dR, Adam H -- why we're all here? (http://twitter.com/civicmit)
8:00pm - Dinner/Drinks @ http://GrendelsDen.com 89 Winthrop St, Harvard Sq. Incl George Hunt & Jessica whisked in from NYC! HALF PRICE DINNER @ 9PM

FRI Apr 6 - 10:00am start @ OLPC HQ. Claudia Urrea can help with TOC, Activity recommendations, etc
10:00-1:00 - OLPC HQ: Getting organized - goals, tools, workflow, work separation, styleguides, etc.
1:00-2:00 - Sunny Lunch on Charles River!
2:00-5:00 - OLPC HQ: Real Work!
5:30-9:30 - DJ Deja @ Museum of Fine Art (DETAILS TBA)

SAT Apr 7 - Passover but working!
10:00-1:00 - Work @ OLPC HQ!
1:00-2:00 - BRING LUNCH/DRINK OFFERINGS to Japanese Blossom Fest on Charles River (urban garden adventure at last!)
2:00-5:00 - Work @ OLPC HQ!

SUN Apr 8 - Easter: Nancie Severs arrives
10:00 - Work @ OLPC HQ!
11:00 - Separate ALEARN Network call
1:00-2:00 - SPECIAL FRISBEE LUNCH right outside OLPC HQ!
2:00-5:00 - Work @ OLPC HQ!
9:30 - Grendel's Den dinner/drinks in Harvard Sq with Mako+Mika!

MON Apr 9 - Paul Fox arrives
10:00-3:45 - Work @ OLPC HQ!
3:30 - Frisbee/Soccer Game @ Charles Park in East Cambridge on the river, betw Binney St & Rogers St (Chris Ball, Laura de Reynal, Adam Holt)
8:00 - Someone pick a *GREAT* dinner location! (TENTATIVE)

TUE Apr 10 - All Day Final Crunch!
10:00-5:00 - Work @ OLPC HQ!

People

Add your name! Include 2 words about the "Chapter" you're contributing!

  • Adam Holt (How to Volunteer/Community, XS chapters)
  • Bernie Innocenti (Apr 6-9?)
  • Bill Stelzer (remote?)
  • Caryl Bigenho (remote from SoCal, already added a Tam Tam Chapter. It is ready for testing!)
  • Cherry Withers (Browse, Addition of Etoys Chapter -- Remote from California)
  • Chris Ball
  • Chris Leonard (translation recommendations)
  • Christoph Derndorfer (Apr 3-10, creating http://j.mp/xomanual#Style_Guide, Introduction, Acknowledgements, Hardware specifications)
  • Claudia Urrea (Apr 6-10?)
  • Craig Perue (Curriculum Arcs; Apr 3-11)
  • CScott Ananian
  • Edward Bigenho (Editing... Remote from SoCal)
  • Edward Mokurai Cherlin (Discovery, Terminal, Turtle Art, Style Guide)
  • Eduardo Silva (Remote from ??)
  • Elise Moussa
  • Ev Batey (Remote from SoCal)
  • George Hunt (Apr 7-9/10)
  • Harriet Vidyasagar Apr 6 remote (7-9) (Tam Tam) Deployment Tool kits.
  • Jennifer Martino & Canadian colleague (Apr 6-9/10, kidnapped to Nicaragua!)
  • Ken Knight (Remote from SoCal)
  • Kenneth Wyrick (Remote from SoCal)
  • Laura de Reynal (Apr 4-10)
  • Luis Galindo (Remote from France)
  • Mike Lee (remote)
  • Mark Roy Battley (Mch 31-Apr 8? Get started, Network, Interface, Speak, Maze, Memorize, Implode, Simplification of language, Pedagogical rationales, Tips and Tricks, FAQ's)
  • Nancie Severs (Apr 8-10)
  • Paul Fox (Apr 9-10)
  • Ralph Bean (Remote from RIT?)
  • Reuben Caron
  • Richard Smith (Apr 6-10?)
  • Rita Freudenberg: eToys
  • Robert Fadel (Sugar Labs' finance officer)
  • Saadia Baloch
  • Sameer Verma (Apr 5-9. XS and Hardware)
  • Sandra Thaxter (Turtle Art AND I'll help MarkB on Memorize and Maze..)
  • Seth Woodworth (Apr 6-10, creating TOC/coordination page!)
  • Shirley Nakatsuru (Remote from SoCal)
  • SJ Klein
  • Tony Anderson (remote from Rwanda/Nepal? Get started, Network, Interface)
  • Tony Forster (Remote from Melbourne Austrailia)
  • Walter Bender (Portfolio, Turtle Art)
  • Yama Ploskonka sorting out if I'm travelling South in those dates, so this is a 'likely', though I'd wish to see y'all agin Sorry, won't be possible Red.png Yamaplos 19:15, 22 March 2012 (UTC)

Table of Contents

NEW Table of Contents: Help_Activity_refresh/TOC

ChristophD & CarylB are explaining live in person & over Skype Noon Fri April 6. Done.

Pre-2012 Help Activity contents

From http://laptop.org/manual especially. You will notice some sections below with (???) after them. We are still looking for volunteers to work on those sections. If you would like to join with one of the other volunteers who is already working on one of the sections, please add your name and contact the person so you can coordinate your work!

  • Introduction (Introduction, About OLPC, What is Sugar, How to Volunteer) (Christoph Derndorfer & Adam Holt, Sandra Thaxter)
  • Getting Started (Getting Started, Opening the XO, Ports, Battery Charging, Starting the XO, Keyboard) (Tony Anderson Mark Battley)
  • Interface (About the User Interface, Home View, Activity View, Neighborhood View, Group View, The Frame, The Journal) (Tony Anderson and Mark Battley, Sandra Thaxter)
  • Activities (What is an Activity, Launching Activities, Switching Views, Collaborating, Exiting Activities, Installing Activities, Activity Sampler) (Tony Anderson and Mark Battley)
  • Network (Give Me The Internet, Connecting, Ad-Hoc Networking, Wireless Devices, Networking Hardware, Troubleshooting) (Tony Anderson and Mark Battley, Sandra Thaxter))
  • Record Activity (Introduction, Starting Record, Photos, Video, Audio, Starting Media, Things to Try, Wikimedia Commons) (Bill Stelzer, Samdra Tjaxter)
  • Browse Activity (Introduction, What Is the Web, Starting Browse, Browse Web, Bookmarks, Changing the View, Sharing Links, Country Quiz, Search the Web, Using Wikipedia, Contribute to Wikipedia, Using Email) Cherry Withers
  • Write Activity (Introduction, Starting Write, Collaborating, Peer Editing, The Basics, Group Story Telling, Letter to the Editor, Emailing a Document (Caryl Bigenho, Sandra Thaxter)
  • Turtle Art (Introduction, Getting Started, Starter Commands, Pen Colors, Pen Commands, Try Turtle Art, Turtle Art Letters, Repeating Commands, Numbers and Commands, Shapes and Spectrum)
  • Support (How to Reflash, Powering of Your Laptop, Replacing, Backing Up, Getting Support)( Sandra Thaxter??? )
  • Appendices (Keyboard Shortcuts, Personalizing Sugar, Glossary, Getting Support, Credits) (Sandra Thaxter???)

Revised manual contents

See Latest: Help Activity refresh/TOC

This section lists the sections and chapters we are working on. It will be changed from time to time as we revise and add. If you add a section or chapter, be sure you have someone to work on it! Also, please add it and the name of the person (or persons) who will be working on it to the section below called "Suggestions for Additional Chapters."

  • Introduction (To include: Unpacking, Battery, and Support)
  • Get Started (To include: Get Started, Interface, Activities (using), and Network)
  • Activities (To include introductions to assorted Activities including, but not limited to: Record, Browse, Write, Turtle Art, Etoys, Tam Tam, Labyrinth, Scratch, and others... see Activity sampler)
  • Appendices (Keyboard Shortcuts, Personalizing Sugar, Glossary, Getting Support, Credits)

Copy of current User Manual

A copy of the current User Manual as it appears in the Help Activity can be found at: http://laptop.org/manual ( currently resolves to http://laptop.org/8.2.0/manual/ )

A more up-to-date/Sugarized edition is Version 13, as included in Release 11.3.0 RC3 / Build 882, downloadable to your XO right here: http://activities.sugarlabs.org//en-US/sugar/addon/4051

If you are working in Windows or Mac OSX you will find instructions for downloading, viewing and editing this in the "Special For..... " notes below. Instructions for Linux users are coming.

Chapters and resources

List of OLD manual chapters:

The above chapters were originally in one larger Manual that is currently the Help Activity. Other early manual versions:

Existing draft chapters

Existing manuals that are incomplete or not added to Help Activity:

Suggestions for new chapters

  • Localization (Registering, Forking, Translating, Adding and Deleting Chapters, Changing Graphics and Images)
  • Tam Tam (What are the Tam Tam Activities, How to Use Each, Where to find lessons, songs, and other resources) Caryl will welcome help!
  • Gnome (What is Gnome? Switching to Gnome and Back to Sugar, Using Gnome, Gnome Applications, Resources for More About Gnome and Its Applications) (Caryl Bigenho)
  • Etoys (Cherry Withers and Rita Freudenberg)
  • About This Floss Manual (Mark Batley)
  • Add a FAQ at the end of each chapter to deal with miscellaneous issues (Mark Battley)
  • Add pedagogical rationale and 'tips and tricks' to each chapter (Mark Battley)
  • Special for the XO-1 (Using the three-section trackpad with Sugar 11.3.0)

How to participate

Read the #Style Guide below!

Start editing here

http://wiki.laptop.org/go/Help_Activity_refresh/TOC

Screenshots

  • Alt + 1 key combination (on XO keyboards) or PrnScn with attached keyboards
  • post-processing with standard laptops and your tools of choice (Paint.Net (Windows) for me)
  • bring your XOs loaded with the latest 11.3.0 development builds since that's the easiest way to get Sugar 0.94
  • for setting up more complex scenes you can also use ImageMagick in the Terminal Activity: sleep 10; import -window root MyScreenshot1.png will give you 10 seconds to set up a scene, then take a screenshot of the full screen, and save it as MyScreenshot1.png (which is not accessible from the Journal so you will need to copy it over to a USB drive via the Terminal's cp command or using GNOME)


Procedures on porting/assembling the manual into Help Activity

Information still needed for this section

Special for Windows users

LEGACY INSTRUCTIONS FOR BOOKI USERS ONLY!

(Contributed byTony Forster in Melbourne Australia)

To edit the Help Activity in Windows

  • download the help sugar bundle

use this link - http://activities.sugarlabs.org//en-US/sugar/downloads/latest/4051/addon-4051-latest.xo

  • unpack the sugar bundle
  • rename help-13.xo to help-13.zip
  • open help-13.zip
  • copy the directory Help.activity to somewhere else
  • go to its help directory

The images can be edited with Paint The htm files can be viewed in a browser The htm files are best edited with something like Frontpage but you can use Notepad or Wordpad if you like working with html

Special for Mac OS X users

LEGACY INSTRUCTIONS FOR BOOKI USERS ONLY!

(Contributed by Caryl Bigenho with help from Tony Forster)

  • Control-click on :

http://activities.sugarlabs.org//en-US/sugar/downloads/latest/4051/addon-4051-latest.xo

  • Choose "Download Linked File As..." (click on it)
  • In the "Save As:" box type " help-13.zip "
  • Choose something for "Where" (desktop is OK)
  • Click the "Save" button

Wait a few minutes for the download. If will give you a 12.6 MB zip file.

Click on it to unzip. It will give you a folder called "Help.activity" full of lots of resources from the activity.

The folder has another folder inside called, "help." Open it.

Find the Activity you are working on. The Chapters and resources for that Section in the Version 13 Help Activity will be there. The Activities are arranged in alphabetical order.

Some of these are html files. Click to highlight the file. You will be in the finder. Click on "File" -> "Open With" -> "Safari". The file will open in Safari and look exactly as it currently appears in the Help Activity on the XO (don't use Firefox for this).

If you have a capable text editor such as TextWrangler ( http://www.barebones.com/products/textwrangler/download.html ) you will be able to see and edit the file in html.

Tasks

Ideas and unassigned tasks

  • keep localization in mind (see the corresponding thread from early October on Sugar-Devel, etc.
  • retain the current chapter format in terms of length and general content. Use links to refer to more in depth resources.
  • use the Activity descriptions in other places such as ASLO, git, etc.

Hands-on testing of chapters with XOs

Want to make sure chapters are correct and easy to understand

Follow up needed

  • with SJ: pdf and openzim export from MediaWiki

Style Guide

Start by reviewing Caryl's Model Chapter!

Some aspects of style should be enforced via CSS. Others require that writers, editors, artists and other be aware of how we have agreed things should be done, such as not translating "Sugar", consistent capitalization, consistent image formats, and the like.

See the OLPC Wiki Style Guide and Sugar Labs' Style Guide as starting point conventions.

Capitalization

  • Activity / Activities
  • OLPC and Sugar are not translated
  • Lots of Capitalized Words

Text

  • suggestions: 1200~1500 words
  • Consider using vocabulary that's also present in the .pot files to speed up / facilitate translation
  • Consider using the translation memory function in lokalize to make this information readily accessible to localizers and translators.
  • Consider using lokalize offline when translating, and uploading finished draft chapters.

Images

  • Image upload: You have to be logged in and then click the UPLOAD FILE link in the Toolbox section on the left-hand side menu (please also note the multiple upload page for uploading up to 5 files at once).
    • when you upload, be sure in the description to give the Activity version and software version:
      Activity Name-NN, OS 11.3.0 / build 883 / Sugar 0.94.1 along with what you're capturing
  • For an image placeholder, either:
    • type the exact words MISSING IMAGE
    • add the wiki markup [[File:Screenshot wanted.png|800px|ActivityName screenshot]] or [[File:Toolbar wanted.png|800px|ActivityName toolbar]] to put a placeholder image in the wiki page.

Must-Do

  • number: max. 4~6 images per page / chapter
  • sizes:
    • screenshots: resized to a max. width of 800px
    • icons: 55px * 55px, activities' SVG icons default to this
  • naming-conventions:
    • screenshot: Chapter[-Feature]-more_description OR Activity_Name-more_description (-es on end if in Spanish, -fr for French, etc.)
    • icons: Chapter[-Feature]-more_description OR Activity_Name-more_description-icon.png or .svg
      • wiki.laptop.org already has most Activities' icons, usually named Activity-activityname.svg , see Special:ListFiles. Many are in Category:SVG. Most icons are years old but most activity icons haven't changed.
  • Annotations, Highlights:
    • Font: Arial
    • Font size: 10pt
    • Colour: Open Office "Light Red" (#ff0000, rgb(255,0,0))
      (note XO laptops do not have the Arial font, so this prevents exporting as SVG)
    • Internationalization: if possible please keep text annotations in a separate layer of your images so they can be switched out easily. You can and should upload the master image or drawing file to the wiki as well as the resulting png image.

Nice to have

Chapter locations

  1. Hardware: on wiki.laptop.org
  2. Core Sugar: on wiki.sugarlabs.org
    • where?
  3. Activities: on wiki.sugarlabs.org (Activity related learning-focused content can be split between w.l.o and s.l.o with good links)

Structure

Suggested Activity Chapter Structure

updated suggestion (by Walter)

  • About <ACTIVITY> (add Activity version which you are referring to)
    • activity's SVG icon
  • Where to get <ACTIVITY>

* Starting <ACTIVITY> -> simply include the icon on top of page (like on the Portfolio page)

  • Using <ACTIVITY>
    • The Toolbars
    • <ACTIVITY-SPECIFIC DESCRIPTIONS>
  • Learning with <ACTIVITY> (-> education context, basically the same as "A word to educators")
  • Extending <ACTIVITY> (focused on expanding the education use: scaffolding, connections to other activities, curriculum arcs)
  • Modifying <ACTIVITY> (focused on modification of software)
  • Where to report problems
    • A word to developers
  • Credits

Paste this into the edit window for any new page you are just starting, and replace the *s with the Activity name:

==About *==

[[file:activity-*.svg]]

(add Activity version which you are referring to)

==Where to get *==


==Using *==


===The Toolbars===


===<Activity-specific descriptions>===


==Learning with *==


==Extending *==


==Modifying *==


==Where to report problems==


==Credits==


== *==


Previous ideas (--> Deprecated)
  • About <ACTIVITY>
  • Where to get <ACTIVITY>
  • Starting <ACTIVITY>
  • Using <ACTIVITY>
    • The Toolbars
    • <ACTIVITY-SPECIFIC DESCRIPTIONS>
  • Applying <ACTIVITY> (-> education context, basically the same as "A word to educators")
  • Extending <ACTIVITY> (basically the same as "Suggestions for modification" / "Suggestions for enhancements")
  • Where to report problems
  • A word to developers
  • Credits

or this suggestion, more child centric? (by Tony Forster)

  • About <ACTIVITY>
  • Starting <ACTIVITY>
  • Using <ACTIVITY>
    • The Toolbars
    • <ACTIVITY-SPECIFIC DESCRIPTIONS>
  • Applying <ACTIVITY> (-> education context, basically the same as "A word to educators")
  • Extending <ACTIVITY> (basically the same as "Suggestions for modification" / "Suggestions for enhancements")
  • Credits

Nice to Have

  • Activity-related pages should include this tag [[Category:Activities|TITLE]] (The TITLE would be the particular Activity Name, which will be used to sort the Category:Activities page.) Would this be better??[[Category:Activity documentation|TITLE]].
  • Possibly use an additional tag like Category:Help Activity content across pages and images, maybe include a version 11.3.0.

Wiki markup tips

Use an HTML comment for notes and ToDos, e.g.

<-- ToDo: re-take screenshot with XO buddy list -->

To link from one chapter to another you can use two dots and a slash (../ChapterName), e.g. [[../The_Frame|Frame]]

Subpages of Help Activity refresh

For only the chapters in order, see the Table of Contents