Difference between revisions of "Development Team/Release"

From Sugar Labs
Jump to: navigation, search
m (Release moved to ReleaseTeam: create releaseteam hierarchy.)
(Fructose (base activity) modules)
 
(111 intermediate revisions by 19 users not shown)
Line 1: Line 1:
== New features proposal ==
+
<noinclude>{{TeamHeader|Development Team|roadmap_link={{Upcoming Stable Release}}/Roadmap}}</noinclude>
 +
== Goals and modules proposal ==
  
At the beginning of each release cycle, maintainers will write a proposal for each major new feature they plan to develop. The [[ReleaseTeam/Contacts|release team's]] role is to help the community to reach a consensus on which features, modules and activities to include.
+
At the beginning of each release [[:Category:Platform Cycle|cycle]], maintainers will work on a set of goals, document them and assign owners. See the upcoming stable release, [[{{Upcoming Stable Release}}/Roadmap]]. (These goals typically involve major interventions or the addition of new components, e.g., someone develops a speech engine specially for his mother tongue and wants it in Sugar. Hence, the process described below is primarily for module maintainers. If you are a developer with a feature or bug fix, you may want to refer to the [[Features/Policy|new feature process]].)
  
=== New activities ===
+
=== New modules proposal ===
  
To propose a new activity send mail to the [http://lists.laptop.org/listinfo/sugar sugar mailing list], providing the following informations:
+
The time period available to make a proposal is indicated on the schedule. To propose a new activity send mail to the [http://lists.sugarlabs.org/listinfo/sugar-devel sugar-devel@lists.sugarlabs.org], providing the following information:
 +
 
 +
(See [[Features/Feature Template]].)
  
 
* Short description of the features.
 
* Short description of the features.
 
* Screenshots or screencasts.
 
* Screenshots or screencasts.
* Are you willing to follow the [[Roadmap#Schedule|Schedule]]?
+
* Are you willing to follow the [[Development Team/Release/Roadmap#Schedule|Schedule]]?
 +
* Are you willing to provide regular source releases? (releases need to be done as well when there are only changes in translations)
 
* System components the activity depends on.
 
* System components the activity depends on.
* Maintainer and members of the developer team, wth links to a User page on the wiki or their homepage on the web.
+
* Maintainer and members of the developer team, with links to a User page on the wiki or their homepage on the web.
 
* Status of internationalization.
 
* Status of internationalization.
 
* Code repository.
 
* Code repository.
Line 22: Line 26:
 
* Does not duplicate the functionalities of other activities.
 
* Does not duplicate the functionalities of other activities.
 
* Provide functionality that the community judges as important for reaching the goals of the project.
 
* Provide functionality that the community judges as important for reaching the goals of the project.
* ...
+
* Maintainer responsiveness and willingness to provide regular releases.  
  
Not required but preferred:
+
<!-- Not required but preferred:
  
* Use the Sugar Labs infrastructure.
+
* Use the Sugar Labs infrastructure. -->
  
 
== Module release ==
 
== Module release ==
  
For both intermediates and final releases module maintainers are responsible to announce the module release and make the sources available. For the first release (0.81.1) if there are no changes to the latest release please just announce the latest one. Note that the release number of the module does not need to follow the Sucrose release number.
+
For both intermediates and final releases module maintainers are responsible to announce the module release and make the sources available. Note that the release number of the module does not need to match the Sucrose release number.
 
More in detail:
 
More in detail:
  
* Build a source tarball, test it carefully and make it available in a stable location. The preferred location is http://dev.laptop.org/pub/sugar/sources/ which translates to: dev.laptop.org:/var/www/sugar/sources/ You need a developer account to be able to upload there.
+
{{Anchor|Glucose}}
* Send an announce mail to devel-announce@lists.sugarlabs.org. The form will be decided by each maintainer but it should at least include a reference to the source code tarball and an high level, user oriented list of changes.
+
=== <abbr title="Glucose, the base Sugar environment">Glucose</abbr> (base) modules===
 
+
* Check out the repository branch,
=== Activity sources ===
+
* Create a git tag to reference the release.  The tag should be in the vXXX form (for example v0.111).
 +
git tag v0.111
 +
* Build a source tarball from the branch,
 +
  make distcheck
 +
* Test the source tarball carefully, using {{Code|configure}}, {{Code|make}}, {{Code|make install}}, and any packaging technology you are familiar with,
 +
* Upload the source tarball to a stable location. You need a developer account with Sugar Labs to be able to upload there. The location for glucose modules is:  
 +
shell.sugarlabs.org:/upload/sources/sucrose/glucose/ (module_name)/  
 +
which translates to:  
 +
http://download.sugarlabs.org/sources/sucrose/glucose/ (module_name)/  
 +
* Push the release tag to the project repository,
 +
git push --tags
 +
* Announce by mail to sugar-devel@lists.sugarlabs.org, with [RELEASE] in the subject. The form will be decided by each maintainer but it should at least include a reference to the source code tarball and a high level, user oriented list of changes.
 +
* When the {{Code|sugar}} module is released, update the Activity Library default stable release; the variable {{Code|SITE_SUGAR_STABLE}} in site/app/config/config.php then check on [https://activities.sugarlabs.org activities.sugarlabs.org] with a browser other than Browse that an activity compatible with the release is listed.
 +
* One week later, check that the corresponding packages have been updated, and if not contact the downstream packager.
 +
{{Anchor|Fructose}}
  
The bundlebuilder script, which is used by the majority of activities, does not support building a source package yet. You will have to it manually for now, with something like this:
+
===<abbr title="Fructose, the base set of demonstration activities">Fructose</abbr> (base activity) modules===
 +
* Check out the branch of the project repository,
 +
* Increment the version number in the activity/activity.info metadata file,
 +
* Update any NEWS file with a list of changes, intended for a teacher or integrator,
 +
* Make the source tarball and bundle, which for most activities is done by {{Code|bundlebuilder}} via {{Code|setup.py}} and will place the result in the {{Code|dist/}} directory:
 +
python setup.py dist_source
 +
python setup.py dist_xo
 +
ls -l dist/
 +
* Create a git tag to reference the release. The tag name should be in the vXXX form (for example v20).
 +
git tag v20
 +
* Test it carefully, to make sure it starts inside Sugar,
 +
* Upload the tarball to a stable location. You need a developer account with Sugar Labs to be able to upload there.
 +
The preferred location for fructose components is:
 +
shell.sugarlabs.org:/upload/sources/sucrose/fructose/ (module_name)/
 +
which translates to:
 +
http://download.sugarlabs.org/sources/sucrose/fructose/ (module_name)/
 +
* Push the release tag to the project repository,
 +
git push --tags
 +
* Upload the bundle to activities.sugarlabs.org, with a high level, learner oriented list of changes, which will cause a release mail to be sent to sugar-devel@lists.sugarlabs.org.
  
git clone git://dev.laptop.org/$NAME $NAME-$VERSION
+
== Sugar release cycle==
+
{{Template:Platform Cycle Linkbar}}
rm -rf $NAME-$VERSION/.git
 
 
tar -cjvf $NAME-$VERSION.tar.bz2 $NAME-$VERSION
 
 
rm -rf $NAME-$VERSION
 
  
== Sugar release ==
 
  
 
Each release cycle will include development, beta, release candidate and final releases. The release team is responsible to coordinate with module maintainers, pull the updated modules together, perform basic QA and announce it. More in detail:
 
Each release cycle will include development, beta, release candidate and final releases. The release team is responsible to coordinate with module maintainers, pull the updated modules together, perform basic QA and announce it. More in detail:
  
 
* Ensure that all the module releases are available by the scheduled date.
 
* Ensure that all the module releases are available by the scheduled date.
* Construct a sugar-jhbuild moduleset out of them. Run automatic and manual QA on it.
+
* Run automatic and manual QA on the releases.
 
* If issues arise coordinate with the relevant module maintainers to solve them.
 
* If issues arise coordinate with the relevant module maintainers to solve them.
* Announce the release on devel-announce@sugarlabs.org, including a reference to the sugar-jhbuild moduleset, references to each source module and a global list of changes.
+
* Announce the release on sugar-devel@lists.sugarlabs.org, including references to each source module and a global list of changes.
 +
 
 +
=== Roadmap Update ===
 +
 
 +
The Development Team's [[{{Upcoming Stable Release}}/Roadmap|Roadmap]] is updated at the beginning of each release cycle by the release team. It may include:
  
== Feature freeze ==
+
* Detailed schedule of release dates and freeze points.
 +
* List of modules and external dependencies.
 +
* Reference to all the tickets considered for the release.
 +
* References to the new feature proposals.
  
The feature freeze affects all the modules included in the release and comprise also strings and ABI for public libraries. Exceptions might be considered by the release team but they will be extremely rare. To request an exception send mail to release-team@sugarlabs.org. It will have to be granted by two [[ReleaseTeam/Contacts|members]] of the team.
+
=== Feature freeze ===
 +
When a Feature Freeze is scheduled, all new features have to be complete, reviewed and pushed to the repository. "Feature" should be interpreted as "Functionality" or "Ability". Bug fixes of existing features are not affected.
  
== Hard code freeze ==
+
This allows developers to concentrate on refining the new features instead of adding yet more functionality.
  
When the hard code freeze is in effect, each and every code change should be approved by the release team. Only critical fixes will be considered. To request approval send mail to release-team@sugarlabs.org, including the patch and a detailed description of the changes, the benefits and the risks. Approval will have to be granted by two [[ReleaseTeam/Contacts#People|members]] of the team.
+
The feature freeze affects all the modules included in the release and comprise also ABI for public libraries. Exceptions might be considered by the release team but they will be extremely rare. To request an exception send mail to [http://lists.sugarlabs.org/listinfo/sugar-devel sugar-devel@lists.sugarlabs.org], referencing the patches you would like to land. It will have to be granted by two [[Development Team/Release/Contacts|members]] of the release team, on the base of community feedback.
  
== Roadmap ==
+
=== UI Freeze ===
 +
When a UI Freeze is scheduled, major UI revisions or changes must be done before this date.
  
The [[Roadmap]] is updated at the beginning of each release cycle by the release team. It includes:
+
This encourages developers to focus on stability and bug-fixing rather than UI changes. At this point, documentation writers do not have to worry that their work will become outdated.  
  
* Detailed schedule of release dates and freeze points.
+
If you really need to do an UI change you have to ask an exception from the release team and must notify the documentation team when accepted.
* List of modules and external dependencies.
+
 
* Reference to all the tickets considered for the release.
+
=== String cooling===
* References to the new feature proposals.
+
When a string freeze is scheduled, string changes have to be announced, but no exceptions have to be requested. As soon as the change is committed in git, notify the [http://lists.laptop.org/mailman/listinfo/localization localization@lists.laptop.org localization list] about it.
 +
 
 +
=== String Freeze===
 +
When a string freeze is scheduled, after the scheduleddate every string change has to be requested and to be approved. Please send an exception to the [http://lists.laptop.org/mailman/listinfo/localization localization@lists.laptop.org localization list] and [http://lists.sugarlabs.org/listinfo/sugar-devel sugar-devel@lists.sugarlabs.org] if you need to break the string freeze and ask for an exception. The localization team lead and two members of the release team need to approve such a break.
 +
 
 +
=== Stabilizing ===
 +
When a stabilizing phase is scheduled, we request every bug fix to be tied to a ticket including a testing plan. Please add the testcase in the ticket comment field. You need to mark it with |TestCase|. This adds better readability and our script that pulls together the test cases for each release is able to find it as well. For example:
 +
|TestCase|
 +
Click on Browse, Read, Pippy icons in the homepage and make sure all of them starts correctly.
 +
 
 +
=== Hard code freeze ===
 +
When a hard code freeze is in effect, each and every code change should be approved by the release team. Only critical fixes will be considered. To request approval send mail to sugar-devel@lists.sugarlabs.org, including the patch and a detailed description of the changes, the benefits and the risks. Approval will have to be granted by two [[Development Team/Release/Contacts#People|members]] of the team.
 +
 
 +
=== Branching ===
 +
 
 +
After the final release of a module, a branch may be created to host further stable development. Please use a name in the form: sucrose-XXX (for example sucrose-0.84). Each module maintainer is responsible to inform the [http://lists.sugarlabs.org/listinfo/sugar-devel sugar-devel@lists.sugarlabs.org] and [http://lists.laptop.org/mailman/listinfo/localization localization@lists.laptop.org] lists about the branch.
 +
 
 +
A new branch is created on the Pootle server, e.g., Fructose-0.96 and Fructose-0.98. The Localization team (the coordinator of a translation team) may push translations to any or all of the corresponding branches of your project. Changes to your master branch are not necessarily intended for the release branches as well.
 +
 
 +
You can create a remote branch like this (in your repository):
 +
 
 +
git branch sucrose-0.98
 +
git push origin sucrose-0.98
 +
 
 +
You can list the remote branches to make sure what is the next one with:
 +
 
 +
git branch --remote
 +
 
 +
You can as well branch off at a specific commit:
 +
 
 +
git checkout -b [commit id] [branch name]
 +
e.g. git checkout -b 1641b9ae0703190df383619202ac33e60c130bb9 sugar-0.96
 +
 
 +
And to work on it (in your repository):
 +
 
 +
git checkout -b sucrose-0.98 origin/sucrose-0.98
 +
git pull
  
 
== Bug triaging ==
 
== Bug triaging ==
Line 78: Line 153:
 
Module maintainers should ensure that their plans for the release are clearly reflected in the bug tracking system. They are responsible to set milestones and priorities accordingly, in cooperation with the release and the QA teams.
 
Module maintainers should ensure that their plans for the release are clearly reflected in the bug tracking system. They are responsible to set milestones and priorities accordingly, in cooperation with the release and the QA teams.
  
Without making it a strict rule, it would be good if each commit or set of commit would have a ticket associated. The ticket number should be always mentioned in the git log and could also be used to automatically build the list of module changes for the releases.
+
Each commit or set of commit should have a ticket associated. The ticket number should be always mentioned in the git log and is used to automatically build the list of module changes for the releases.
 
 
There is a more detailed discussion of the triage process [[BugSquad/ContentToEdit/Triage|here]].
 
 
 
== Automation ==
 
  
TBD Many of the steps described in this document can be easily automated for maintainers which are using the Sugar Labs infrastructure and for the release team. Though as a first pass we want to get the workflow right, even if it involves more manual step than strictly required.
+
==Related pages==
 +
{{Template:Platform Cycle Linkbar}}
  
[[Category:Developer]]
+
See also [[:Category:Release Notes]]{{Special:PrefixIndex/{{PAGENAME}}/}}

Latest revision as of 19:51, 16 January 2018

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

Goals and modules proposal

At the beginning of each release cycle, maintainers will work on a set of goals, document them and assign owners. See the upcoming stable release, 0.114/Roadmap. (These goals typically involve major interventions or the addition of new components, e.g., someone develops a speech engine specially for his mother tongue and wants it in Sugar. Hence, the process described below is primarily for module maintainers. If you are a developer with a feature or bug fix, you may want to refer to the new feature process.)

New modules proposal

The time period available to make a proposal is indicated on the schedule. To propose a new activity send mail to the sugar-devel@lists.sugarlabs.org, providing the following information:

(See Features/Feature Template.)

  • Short description of the features.
  • Screenshots or screencasts.
  • Are you willing to follow the Schedule?
  • Are you willing to provide regular source releases? (releases need to be done as well when there are only changes in translations)
  • System components the activity depends on.
  • Maintainer and members of the developer team, with links to a User page on the wiki or their homepage on the web.
  • Status of internationalization.
  • Code repository.
  • Bug tracking system.
  • Homepage.

Criteria for approval will be:

  • Supports internationalisation and localisation.
  • Does not duplicate the functionalities of other activities.
  • Provide functionality that the community judges as important for reaching the goals of the project.
  • Maintainer responsiveness and willingness to provide regular releases.


Module release

For both intermediates and final releases module maintainers are responsible to announce the module release and make the sources available. Note that the release number of the module does not need to match the Sucrose release number. More in detail:

Glucose (base) modules

  • Check out the repository branch,
  • Create a git tag to reference the release. The tag should be in the vXXX form (for example v0.111).
git tag v0.111
  • Build a source tarball from the branch,
 make distcheck
  • Test the source tarball carefully, using configure, make, make install, and any packaging technology you are familiar with,
  • Upload the source tarball to a stable location. You need a developer account with Sugar Labs to be able to upload there. The location for glucose modules is:
shell.sugarlabs.org:/upload/sources/sucrose/glucose/ (module_name)/ 

which translates to:

http://download.sugarlabs.org/sources/sucrose/glucose/ (module_name)/ 
  • Push the release tag to the project repository,
git push --tags
  • Announce by mail to sugar-devel@lists.sugarlabs.org, with [RELEASE] in the subject. The form will be decided by each maintainer but it should at least include a reference to the source code tarball and a high level, user oriented list of changes.
  • When the sugar module is released, update the Activity Library default stable release; the variable SITE_SUGAR_STABLE in site/app/config/config.php then check on activities.sugarlabs.org with a browser other than Browse that an activity compatible with the release is listed.
  • One week later, check that the corresponding packages have been updated, and if not contact the downstream packager.

Fructose (base activity) modules

  • Check out the branch of the project repository,
  • Increment the version number in the activity/activity.info metadata file,
  • Update any NEWS file with a list of changes, intended for a teacher or integrator,
  • Make the source tarball and bundle, which for most activities is done by bundlebuilder via setup.py and will place the result in the dist/ directory:
python setup.py dist_source
python setup.py dist_xo
ls -l dist/
  • Create a git tag to reference the release. The tag name should be in the vXXX form (for example v20).
git tag v20
  • Test it carefully, to make sure it starts inside Sugar,
  • Upload the tarball to a stable location. You need a developer account with Sugar Labs to be able to upload there.

The preferred location for fructose components is:

shell.sugarlabs.org:/upload/sources/sucrose/fructose/ (module_name)/ 

which translates to:

http://download.sugarlabs.org/sources/sucrose/fructose/ (module_name)/
  • Push the release tag to the project repository,
git push --tags
  • Upload the bundle to activities.sugarlabs.org, with a high level, learner oriented list of changes, which will cause a release mail to be sent to sugar-devel@lists.sugarlabs.org.

Sugar release cycle

Sugar platform release version cycle: | 0.82 | 0.84 | 0.86 | 0.88 | 0.90 | 0.92 | 0.94 | 0.96 | 0.98 | 0.100 | 0.102 | 0.104 | 0.106 | 0.108 | 0.110 | 0.112 |


Each release cycle will include development, beta, release candidate and final releases. The release team is responsible to coordinate with module maintainers, pull the updated modules together, perform basic QA and announce it. More in detail:

  • Ensure that all the module releases are available by the scheduled date.
  • Run automatic and manual QA on the releases.
  • If issues arise coordinate with the relevant module maintainers to solve them.
  • Announce the release on sugar-devel@lists.sugarlabs.org, including references to each source module and a global list of changes.

Roadmap Update

The Development Team's Roadmap is updated at the beginning of each release cycle by the release team. It may include:

  • Detailed schedule of release dates and freeze points.
  • List of modules and external dependencies.
  • Reference to all the tickets considered for the release.
  • References to the new feature proposals.

Feature freeze

When a Feature Freeze is scheduled, all new features have to be complete, reviewed and pushed to the repository. "Feature" should be interpreted as "Functionality" or "Ability". Bug fixes of existing features are not affected.

This allows developers to concentrate on refining the new features instead of adding yet more functionality.

The feature freeze affects all the modules included in the release and comprise also ABI for public libraries. Exceptions might be considered by the release team but they will be extremely rare. To request an exception send mail to sugar-devel@lists.sugarlabs.org, referencing the patches you would like to land. It will have to be granted by two members of the release team, on the base of community feedback.

UI Freeze

When a UI Freeze is scheduled, major UI revisions or changes must be done before this date.

This encourages developers to focus on stability and bug-fixing rather than UI changes. At this point, documentation writers do not have to worry that their work will become outdated.

If you really need to do an UI change you have to ask an exception from the release team and must notify the documentation team when accepted.

String cooling

When a string freeze is scheduled, string changes have to be announced, but no exceptions have to be requested. As soon as the change is committed in git, notify the localization@lists.laptop.org localization list about it.

String Freeze

When a string freeze is scheduled, after the scheduleddate every string change has to be requested and to be approved. Please send an exception to the localization@lists.laptop.org localization list and sugar-devel@lists.sugarlabs.org if you need to break the string freeze and ask for an exception. The localization team lead and two members of the release team need to approve such a break.

Stabilizing

When a stabilizing phase is scheduled, we request every bug fix to be tied to a ticket including a testing plan. Please add the testcase in the ticket comment field. You need to mark it with |TestCase|. This adds better readability and our script that pulls together the test cases for each release is able to find it as well. For example:

|TestCase|
Click on Browse, Read, Pippy icons in the homepage and make sure all of them starts correctly.

Hard code freeze

When a hard code freeze is in effect, each and every code change should be approved by the release team. Only critical fixes will be considered. To request approval send mail to sugar-devel@lists.sugarlabs.org, including the patch and a detailed description of the changes, the benefits and the risks. Approval will have to be granted by two members of the team.

Branching

After the final release of a module, a branch may be created to host further stable development. Please use a name in the form: sucrose-XXX (for example sucrose-0.84). Each module maintainer is responsible to inform the sugar-devel@lists.sugarlabs.org and localization@lists.laptop.org lists about the branch.

A new branch is created on the Pootle server, e.g., Fructose-0.96 and Fructose-0.98. The Localization team (the coordinator of a translation team) may push translations to any or all of the corresponding branches of your project. Changes to your master branch are not necessarily intended for the release branches as well.

You can create a remote branch like this (in your repository):

git branch sucrose-0.98
git push origin sucrose-0.98

You can list the remote branches to make sure what is the next one with:

git branch --remote

You can as well branch off at a specific commit:

git checkout -b [commit id] [branch name]
e.g. git checkout -b 1641b9ae0703190df383619202ac33e60c130bb9 sugar-0.96

And to work on it (in your repository):

git checkout -b sucrose-0.98 origin/sucrose-0.98
git pull

Bug triaging

Module maintainers should ensure that their plans for the release are clearly reflected in the bug tracking system. They are responsible to set milestones and priorities accordingly, in cooperation with the release and the QA teams.

Each commit or set of commit should have a ticket associated. The ticket number should be always mentioned in the git log and is used to automatically build the list of module changes for the releases.

Related pages

Sugar platform release version cycle: | 0.82 | 0.84 | 0.86 | 0.88 | 0.90 | 0.92 | 0.94 | 0.96 | 0.98 | 0.100 | 0.102 | 0.104 | 0.106 | 0.108 | 0.110 | 0.112 |

See also Category:Release Notes