Documentation: Difference between revisions

From OLPC
Jump to navigation Jump to search
(exs)
(some ideas and needs)
Line 5: Line 5:
There are many audiences for the laptops and their software and content; some of them may need to create their own instructional material, or their own versions of existing material. This wiki is open for development of such material. If you have created your own documentation -- for instance, text, screenshots, video or animation for the hardware or specific software that is being turned into an activity -- note it here.
There are many audiences for the laptops and their software and content; some of them may need to create their own instructional material, or their own versions of existing material. This wiki is open for development of such material. If you have created your own documentation -- for instance, text, screenshots, video or animation for the hardware or specific software that is being turned into an activity -- note it here.


== Notes ==
== TODO ==
We need to improve speed/accuracy of
We need to improve speed/accuracy of
() noting the need for pascals doc
() noting the need for pascals doc
Line 13: Line 13:
() keeping the docs up to date / tagged with freshness indicators
() keeping the docs up to date / tagged with freshness indicators


== Text ==
== Needs ==
* Comments in code -- clean up, write for children, translate
* Notes about development -- how to create a 'hello world' activity or bundle
* Community introduction -- getting to know and collab with the social community of developers and supporting groups
* Packaging/downloading guide -- how to package, where to publish, how to find and download
* Testing guide -- how to write test plans, who tests, how to help test, how to read the results of automated / human tests
* Build/release guide -- how builds are made how often, where they end up; stable v unstable; how an activity gets into a buld

== Specific examples ==
=== Wikitexts ===
* [[Guidelines|General introduction]] and user interface guidelines
* [[Guidelines|General introduction]] and user interface guidelines
* [[OS_images_for_emulation|Emulating the OLPC environment]] on another computer
* [[OS_images_for_emulation|Emulating the OLPC environment]] on another computer
Line 19: Line 28:
* [[xo "how to" notes]]
* [[xo "how to" notes]]


== Images/Pictures ==
=== Images/Pictures ===
* (from c.xu - will place here.-tk)
* (from christina xu... to find on Flickr)


== Tutorial ==
=== Tutorials ===
* [[Forth Lessons]]
* [[Forth Lessons]]


== Video ==
=== Videos ===
* [http://www.youtube.com/watch?v=MShr7ZHsOfI&mode=related&search= Etoys tutorial]
* [http://www.youtube.com/watch?v=MShr7ZHsOfI&mode=related&search= Etoys tutorial]
* [http://www.youtube.com/watch?v=5sHzq5eOxdg&mode=related&search= User interface introduction]
* [http://www.youtube.com/watch?v=5sHzq5eOxdg&mode=related&search= User interface introduction]

Revision as of 18:02, 13 October 2007

OLPC hardware and software is designed to be discoverable so that a user can figure things out by experimentation. We are preparing teachers by extensively lecturing and writing about how the devices might be leveraged. The OLPC laptops will come with e-books documenting how to use them, and technical details needed by application developers are available on the web including this wiki.

Examples: see the user interface guidelines and a draft developers handbook.

There are many audiences for the laptops and their software and content; some of them may need to create their own instructional material, or their own versions of existing material. This wiki is open for development of such material. If you have created your own documentation -- for instance, text, screenshots, video or animation for the hardware or specific software that is being turned into an activity -- note it here.

TODO

We need to improve speed/accuracy of

() noting the need for pascals doc
() making sure it gets created
(*) integrating it with other such docs in a organizing framework
() having an organizing framework 
() keeping the docs up to date / tagged with freshness indicators

Needs

  • Comments in code -- clean up, write for children, translate
  • Notes about development -- how to create a 'hello world' activity or bundle
  • Community introduction -- getting to know and collab with the social community of developers and supporting groups
  • Packaging/downloading guide -- how to package, where to publish, how to find and download
  • Testing guide -- how to write test plans, who tests, how to help test, how to read the results of automated / human tests
  • Build/release guide -- how builds are made how often, where they end up; stable v unstable; how an activity gets into a buld

Specific examples

Wikitexts

Images/Pictures

  • (from christina xu... to find on Flickr)

Tutorials

Videos