Activity Team/How to migrate from OLPC: Difference between revisions

Bjordan (talk | contribs)
m trac link emphasizing choice of activity component
 
(20 intermediate revisions by 12 users not shown)
Line 1: Line 1:
== Migrating activities from dev.laptop.org ==
== Migrate the code ==
 
* If you are not the author of the activity, '''query''' the author to let them know about the move.
* If you are not the author of the activity, '''query''' the author to let them know about the move.
* '''Create''' an account on http://git.sugarlabs.org and '''log in'''. Add your public SSH key to [http://git.sugarlabs.org/account your account].
* '''Create''' an account on http://git.sugarlabs.org and '''log in'''. Add your public SSH key to [http://git.sugarlabs.org/account your account].
* '''[http://git.sugarlabs.org/projects/new 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"'''.
* '''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"'''.
* '''Clone''' your activity from [http://dev.laptop.org/git dev.laptop.org].
* '''Clone''' your activity from [http://dev.laptop.org/git dev.laptop.org].
  git-clone git://dev.laptop.org/projects/pippy-activity
  git clone git://dev.laptop.org/projects/pippy-activity
* '''If''' you want to migrate a non-master branch...
* '''If''' you want to migrate a non-master branch...
  git remote show origin
  git remote show origin
  git checkout -b sucrose-0.82 origin/sucrose-0.82
  git checkout -b sucrose-0.82 origin/sucrose-0.82
* '''Push''' to git.sugarlabs.org with something like:
* '''Push''' to git.sugarlabs.org with something like:
git push gitorious@git.sugarlabs.org:sugar/mainline.git --mirror
* '''Clone''' the project from the new repository in order to be able to push your changes.  You'll need to do a git clone into an empty directory, using the same URL you used with your previous push:
git clone gitorious@git.sugarlabs.org:sugar/mainline.git sugar
If you're getting a message saying '''fatal: The remote end hung up unexpectedly''' that probably means that this URL is incorrect.


  git push gitorious@git.sugarlabs.org:sugar/mainline.git --mirror
== Set up SugarLabs services ==
* '''Add''' the pootle user as a committer (from the "add committer" link on the mainline page) and send mail to [[User:RafaelOrtiz|dirakx]] to point pootle to new remote.
* '''Upload a xo bundle''' to [http://activities.sugarlabs.org/ activities.sugarlabs.org]. Be sure to include a couple of screenshots of your activity in action.
* If your activity is part of Fructose, '''upload a .tar.bz2''' to [http://download.sugarlabs.org/ download.sugarlabs.org].  Request a shell account from the [[Infrastructure Team]] if you don't have one already.
* '''Update the OLPC wiki page''' for the Activity, noting the migration. Use the [http://wiki.laptop.org/go/Template:Migrated_to_sl.o Migrated to sl.o] template.
* '''Change sugar-jhbuild''' to point to the new repository if this activity was included in sugar-jhbuild (enter a ticket in http://dev.sugarlabs.org if you have no access).
* Ask an [[Activity Team/Contacts|Activity Team Coordinator]] to create a '''Trac component''' for your activity.


* '''Add''' the pootle user as a committer (from the "add committer" link on the mainline page) and send mail to [[User:SayaminduDasgupta|Sayamindu]] to point pootle to new remote.
== Notify the community ==
* '''Upload''' xo bundles and .tar.bz2 files to download.sugarlabs.org.
* '''Notify''' [http://lists.sugarlabs.org/listinfo/sugar-devel sugar-devel] and [http://lists.laptop.org/listinfo/devel OLPC devel] about the move.
* '''Notify''' [http://lists.sugarlabs.org/listinfo/sugar-devel sugar-devel] and [http://lists.laptop.org/listinfo/devel OLPC devel] about the move.
* '''Make sure''' that sugar-jhbuild points to the new repository (enter a ticket in http://dev.sugarlabs.org if you have no access)
* Transfer or resolve '''existing tickets''' related to the code in the [http://dev.laptop.org/query?status=assigned&status=new&status=reopened&component=acoustic-measure-activity&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=milestone OLPC Trac].
* Transfer or resolve '''existing tickets''' related to the code in the [http://dev.laptop.org/query?status=assigned&status=new&status=reopened&component=acoustic-measure-activity&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=milestone OLPC Trac].
* Update pages on wiki.laptop.org that contain '''stale links''' to the OLPC repo and latest bundle.  (e.g. Activities/All , the OBX box on the activity homepage, etc.) See [[olpc:Maintaining activity web information#Migrating activities to SugarLabs]]
* Update any pages on wiki.laptop.org that may contain '''stale links''' to OLPC repo.  (e.g. Activities/All , the OBX box on the activity homepage, etc.)
* '''Tag''' the activity at [[Activity Team/Activity Status]] as '''migrated'''.
 
== Clean up wiki.laptop.org ==
Adjust the activity's old wiki page on wiki.laptop.org:
* Put the <nowiki>{{</nowiki>[[olpc:Template:Activity migrated to sl.o|Activity migrated to sl.o]]}} template at the top of the old wiki page.
* Clean up the information on the old wiki page.  You can either continue to update the "OBX" badges and semantic information on it, or remove most of this information.
 
You need to continue to maintain the activity's "activity template fragment"(s) on wiki.laptop.org such as [[olpc:Activities/Etoys (latest)|Activities/Etoys (latest)]].
 
For more information on wiki.laptop.org activity pages, see [[olpc:Maintaining activity web information]].
 
[[Category:Activity Team]]