NEXO: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
No edit summary
Line 13: Line 13:
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.
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.
Your change is now ready for inclusion in the next NEXO build, but there is one last step: Update [[#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.
After a new NEXS release has been deemed deployment-ready, update the [[NEXO]] page to state that this is the most recent stable release.


=== Development process ===
=== Development process ===
...


=== Build system ===
=== Build system ===
Line 38: Line 39:


=== Release notes ===
=== Release notes ===
...






Revision as of 08:42, 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 below on the build system section.

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 [[#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.

Development process

...

Build system

...

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 [[#Development process|]] to add the new activity to the OLPC_CORE_ACTIVITIES variable in /home/pilgrim/pilgrim/streams.d/olpc-development.stream (see the [[#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.

Release notes

...


Notes for developers and testers

See also the [[#Development process|]] above.


Related projects

There are also NEXS and NEXC projects, related to the server and the C?...

NEXS and NEXC development

...