Talk:Help Activity refresh
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