Activity Team/Getting Involved

From Sugar Labs
Jump to: navigation, search

Team Home   ·   Join   ·   Contacts   ·   Resources   ·   FAQ   ·   Roadmap   ·   To Do   ·   Meetings

Install Sugar

The easiest way is installing sugar from native packages.

If your favourite GNU/Linux distribution doesn't provide sugar or contains out-of-dated packages(in most cases you don't need latest minor release(like 0.82.1, 0.84.1), the good practise is looking for the last major release(0.82, 0.84)) you could consider possibility to use sugar-jhbuild - the system used by core developers to build sugar from last git sources.

As an activity developer in most cases you need only glucose module(its included to sugar-glucose or sugar packages).

If you want to create your own activity

What you need to do to create or share your activity.

Start coding

  • Create an account on http://git.sugarlabs.org and log in. Add your public SSH key to your account.
  • Create a new project (http://git.sugarlabs.org, projects, new). Make your project name lowercase, e.g. pippy, turtleart, paint. Put it in category "activities".
  • Initiate your project
  • Use can copy/paste Hello World activity to get an example of usual files hierarchy.
  • You can place your activity to ~/Activities/activity-name.activity directory.
    To test your activity in sugar environment:
    • use sugar command to run sugar as a regular window manager
    • use sugar-emulator command to run sugar in window mode(in Xephyr), could be useful to test your activity in current environment without re-loginning.
  • Start coding :)

Share your activity

If you want to share your activity for broad audience(it could be not final release):

  • Open a ticket on dev.sugarlabs.org to create component for your activity e.g. [1]
  • Using setup.py from activity root directory, create .pot file
  • Add the pootle user as a committer (from the "add committer" link on the mainline page) and send mail to Sayamindu to point pootle(sugar translation environment) to new remote.
  • Open a ticket on dev.sugarlabs.org to add your activity to pootle e.g. [2]
  • Upload a xo bundle(use setup.py to create bundle) to addons.sugarlabs.org.
    • Be sure to include a couple of screenshots of your activity in action.
    • Nominate your activity to the public

Join the Activity Team

The Activity Team is newly formed and we are seeking members.

If you would like to join:

  1. Create a User page on wiki.sugarlabs.org if you have not already.
  2. Copy your SSH public key into your User page.
  3. Add a link to your User page to Activity Team/Contacts.
  4. Subscribe, and send an email introducing yourself to sugar-devel@lists.sugarlabs.org.

If you are an independent developer who is interested in working on a Sugar activity, please introduce yourself and your project in an email to sugar-devel@lists.sugarlabs.org.

Help the Activity Team

If you'd rather just start coding right now, it's easy to do!

  • Check Activity Team/TODO for ideas to work on. To start small, pick an Activity Feature Request. If you'd rather work on something harder, try one of the High Impact Tasks.
  • If you haven't already set up Sugar, see Activity Team/Resources.
  • Clone the Git repository for the project you picked and register it with Sugar.
git clone <project_url>
cd project_name
python setup.py dev
(Ctrl-Alt-Erase to restart Sugar)
  • Hack on the source code.
  • Create a patch file containing your changes.
git commit
git format-patch -1
  • Email 0001-My-change-description.patch to sugar-devel@lists.sugarlabs.org.