Talk:Help Activity refresh

From OLPC
Jump to navigation Jump to search

Notes from 2011

Brainstorming during the Meeting on 21 October 2011

  • decide on audience: basics for all -> teachers, pupils, parents
  • what to include
  • needed: manual not just for Haiti, making it more accessible, how to do that
  • slideshow approach -> make different language audio tracks, also needs different language screenshots
  • add four-finger salute
  • collecting existing documentation: including for example the latest Peruvian manual
  • chat as an example of collaboration
  • Memorize documentation
  • Maze -> include "why to teach this thing"
  • recommended approach
  • basics: learn the interface
  • Speak
  • progression levels
  • ...more specific & comprehensive Activity manuals
  • juggling / hammer on head / metaphors
  • content / how to do it / rationale (3 levels for teachers)
  • stylus feature: how to tell when you can use it, what you can use it for
  • Acknowledgement: depends on XO version, software build -> "about this manual" section (incl. limitations)
  • including FAQs for each section & each chapter (at the end)
  • contact information (depending on country)
  • how-to add something to Flossmanuals
  • presentation, structure, orders, labels -> organization needed
  • add glossary chapter (see Glossary)
  • documentation styleguide: consistency is important (!)
  • importance of simple + clear language
  • potential todo: simply language + presentation