NEXO: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
(..)
Line 8: Line 8:
Most NEXO development tasks can be grouped under 2 categories:
Most NEXO development tasks can be grouped under 2 categories:


# Activity updates (or addition of new activities): this process is documented at [[NEXO activity updating]]
# Activity updates (or addition of new activities): this process is documented below in the [[#Updating activities|updating activities]] section.
# Tweaks on top of underlying OLPC OS through pilgrim at /home/pilgrim: the internals are documented at [[NEXO build system]]
# Tweaks on top of underlying OLPC OS through pilgrim at /home/pilgrim: the internals are documented at [[NEXO build system]]



Revision as of 08:38, 19 December 2009

NEXO is a collection of activities and other material designed for use on XOs in Nepal. (is it an entire XO image, from Fedora and Sugar to the full activity suite? If so, designed to boot from NAND, from an SD card, both?)

Background & how to use NEXO

...

Development

Most NEXO development tasks can be grouped under 2 categories:

  1. Activity updates (or addition of new activities): this process is documented below in the updating activities section.
  2. Tweaks on top of underlying OLPC OS through pilgrim at /home/pilgrim: the internals are documented at NEXO build system

Before making any change, you should have fully tested it on an individual XO. At this point, you can make the change on the pilgrim box (192.168.5.233) as the pilgrim user. If your change involved changing anything under the pilgrim repository, please make sure to commit and push your changes.

Your change is now ready for inclusion in the next NEXO build, but there is one last step: Update NEXO release notes with your change. If you need to, create a new entry at the top of the page labelled simply "Unreleased development version" or similar (otherwise, append to the development entry that already exists). When released, the build master will assign an appropriate version number and release date and send the list of changes to the team.

After a new NEXS release has been deemed deployment-ready, update the NEXO page to state that this is the most recent stable release.


Updating activities

To add a new version of an activity (or a brand new activity) for inclusion in a future NEXO build:

  1. On your own computer, access the Deployment share of the fileserver.
  2. Put the new or updated activity in the NEXO/activities directory
  3. Clean up the activities directory: remove old versions
    • This is important because this directory (in entirity) is synchronized to the school servers, sometimes over slow network links

If this is a new activity:

  1. Follow the NEXO development process to add the new activity to the OLPC_CORE_ACTIVITIES variable in /home/pilgrim/pilgrim/streams.d/olpc-development.stream (see NEXO build system for details) -- remember to commit and push your changes.
    • Ask the NEXO build master to do this step for you, if you prefer

Your activity is now ready for inclusion in the next NEXO build.

NEXS and NEXC development

Notes for developers and testers

See also the NEXO Development Process