Eclipse 3.0
Endgame Plan

Updated frequently to reflect current status

Status

Friday June 25, 2004 18:00 EDT Status: Eclipse release 3.0 has left the building! Congratulations and thanks to everyone in the Eclipse community who help make it happen.

Detailed Timeline
May 2004 
7 Fri 17:00 EDT   Transition to fix and polish mode      details   
21 Fri 00:10 EDT   Release Candidate 0 build     goals   
28 Fri 00:10 EDT   Release Candidate 1 build      goals   
June 2004 
1 Tue 08:00 EDT   Start 2-day test pass against RC1      details   
3 Thu 08:00 EDT   Start fix pass      rules   
11 Fri 00:10 EDT   Release Candidate 2 build     goals   
14 Mon 08:00 EDT   Start 2-day test pass against RC2      details   
16 Wed 08:00 EDT   Start fix pass      rules   
18 Fri 00:10 EDT   Release Candidate 3 build      goals   
21    Mon 08:00 EDT   All-day test pass against RC3     details   
22 Tue 08:00 EDT   Start fix pass      rules   
25 Fri 00:10 EDT   Release Candidate 4 build     goals   
  Release 3.0 available      details   
Useful Links

Component Test Plans - info on how to test each of the components.

Build Schedule - details on build times.

Eclipse Project Bug Counts - summarizes all known outstanding bugs.

Eclipse Release Checklist - lists various things that need to be checked before each release.

Eclipse Project Draft 3.0 Plan

What is the game plan?

The Eclipse 3.0 release endgame involves a sequence of test/fix passes leading to the official 3.0 release. Even more than at other times, we welcome all the help we can get with testing and fixing the various Eclipse release candidates. To participate effectively everyone needs to track this schedule closely so that we end up testing the latest release candidate and entering bugzilla bug reports in time to be considered for the fix pass that immediately follows, giving rise to the next release candidate. Throughout the process, we are most concerned with "stop ship" (P1) bugs that must be fixed before we can declare that we have a release. If we discover a "stop ship" bug late in the process, we may have to slip the schedule to allow it to be fixed and retested. This is why it is so important to ferret out "stop ship" bugs as early as possible, while there is still time left in the schedule to address them. Most of the bugs that will be uncovered will be less serious. During the fix passes, we prioritize the less serious bugs and try to fix as many of the important ones as possible without jeopardizing the schedule or the overall stability of the release. We're always on the look out for "regression" type bugs where we somehow manage to break something that had been working fine before. Regressions are an important warning sign that our optimism and enthusiasm is outpacing our understanding and abilities. Calling special attention to regressions helps us to collectively bring our head back in line with our feet, so to speak. With each cycle, we gradually raise the bar on the kinds and numbers of changes that we will consider making, until we reach a point where we would only fix "stop ship" bugs and regressions. (The lesser bugs that we don't end up fixing will be reconsidered for the next release.) Because of this progressive tightening, the windows of opportunity for fixing problems within the schedule are relatively narrow. Things works best if everyone pushes in the right direction on the right things at the right times. As it is virtually impossible to work out all the details in advance, we will be updating this page regularly to reflect current status and current testing emphasis. If you are participating we suggest you bookmark this page in your browser and check back frequently for updates. General announcements during the endgame are posted to the platform-releng-dev@eclipse.org developer mailing list. Anyone participating in the endgame should be subscribed to this list, and should direct any general questions and comments about the process there as well.

Release Candidate - Release candidates are like stable builds, only better. We test each release candidate to find serious bugs and to increase our confidence in what we have. We then fix the serious bugs in each release candidate to get the next release candidate, which ought to be even better. Each release candidate build is kicked off at the indicated time, with the goal being to have a release candidate available within 24 hours. As the build is ready, all of the teams validate it and declare it either "go" of "no go" for testing. Getting a build that is testable may require a few attempts. These happen in rapid succession, and we continue rebuilding and revalidating until we have our next release candidate. It is critical that we have enough time to do test passes. We will slide the schedule and use weekends as necessary if there are delays of more than 24 hours in getting a viable release candidate. Note that we will also do warm-up builds in the days leading up to each release candidate build to do early integration of fixes.

Test Pass - Once we have a release candidate build in hand, we enter an intensive test pass for a limited period of time. Each component team is responsible for preparing a comprehensive test plan for their component. These component test plans cover all the functionality that requires manual testing, and identifies the operating environments in which the testing needs to be done. Each component team is responsible for staffing and carrying out their test plan each cycle. Each component team is expected to have most of the team testing throughout each test pass (a small subset of the team may be focused on concurrently preparing candidate fixes for "stop ship" bugs or other high priority tasks). Everyone in the Eclipse community is encouraged to participate in test passes and report bugs to bugzilla. Ideally, the bug report should explicitly call attention to regressions and potential "stop ship" problems.

Fix Pass - After each test pass, we analyze and prioritize the set of outstanding bugs and enter an intensive fix pass for a limited period of time where we try to fix the most pressing problems. The bugs that we intend to fix for the next release candidate are tagged accordingly (e.g., a bug tagged as Target 3.0 RC1 should be fixed as of the release candidate 1 build). "stop ships" and regressions are always given first priority; less severe problems are addressed by decreasing priority and as many as possible are fixed in the time available. With each successive release candidate, we also tighten the rules for the kinds of changes will be allowed to the code base and increase the number of people that check the changes before they are released. The rules apply to any and all changes to the code. Any committer for any Eclipse component can perform the checking duties. All committers for a component have the right to veto a change (with an explanation) even after it has been released into the code base. If such a veto occurs, the change automatically comes out until the vetoing committer's concerns are addressed. The committer who releases a given change, the person that checks the change, and the component leads that approved making the change in the first place, are jointly responsible for seeing it through. In other words, we expect a strong commitment to personally help fix any problems caused by changes made in fix passes.

Details
Feature and API freeze
Notes:
  • All components transition on May 7 to polishing and fixing bugs for remainder of release cycle.
  • PMC approval is required for feature work (including API changes) being done between May 7 and May 21 (feature set and API freeze).
 
RC0
Goals:
  • All components feature complete.
  • String externalization complete (including mnemonics).
RC1
Goals:
  • Accurate prioritization of all outstanding defects.
  • No outstanding P1 defects.
  • As few P2 defects as possible.
  • 3.0 test plans posted.
Test pass using RC1
Notes: Concerted 2-day testing effort using RC1 involving entire community including all component teams. May 31 is a holiday in US, France, and Switzerland. That's why this test pass starts on Tuesday rather than on Monday.
RC2
Goals:
  • Final artwork in place.
  • Accurate prioritization of all outstanding defects.
  • No outstanding P1 defects.
  • As few P2 defects as possible.
Test pass using RC2
Notes: Concerted 2-day testing effort on RC2 involving entire community including all component teams. In an effort to mix things up and hold off the onset of "tester fatigue", each component team will be designating one team member that will be assigned to test some other component.
RC3
Goals:
  • Accurate prioritization of all outstanding defects.
  • No outstanding P1 defects.
  • As few P2 defects as possible.
Test pass using RC3
Notes: Concerted 1-day testing effort on RC3 involving entire community including all component teams, searching for regressions and on the lookout for undiscovered "stop ship" defects.
RC4
Goals:
  • Documentation complete.
  • Accurate prioritization of all outstanding defects.
  • Stable code base; no outstanding P1 defects.
Release 3.0
Goal: Ship Eclipse 3.0 during the week on June 28.
Notes: There is no formal test pass for RC4 and beyond other than to check for last minute regressions. We will perform sanity checking focused on documentation. Release 3.0 should be complete and available for download as soon as we are satisfied with it.
Fix pass rules of engagement
May 8-20
contributions to RC0
Focus: Defects, performance, and polish. But no new feature work. PMC approval is required for work on new features.
Fix approval: None.
API change approval: PMC must approve all API changes. No changes are to be released without prior approval and associated bug report.
Notification requirements: None.
Extra checking requirements: None. (However extra checking is always a good idea.)
May 22-27
contributions to RC1
Focus: (1) P1 defects, (2) performance defects, (3) special "polish" defects. Fixing other defects has lower priority.
Fix approval: Component lead must approve all work on a component. No changes are to be released without prior approval and associated bug report tagged 3.0RC1. (Ongoing changes to component documentation do not require special approval.)
API change approval: PMC must approve all API changes. No changes are to be released without prior approval and associated bug report.
Notification requirements: None.
Extra checking requirements: None. (However extra checking is always a good idea.)
June 3-10
contributions to RC2
Focus: (1) P1 defects, (2) performance defects, (3) special "polish" defects. Fixing other defects has lower priority.
Fix approval: Component lead must approve all work on a component. No changes are to be released without prior approval and associated bug report tagged 3.0RC2. (Ongoing changes to component documentation do not require special approval.)
API change approval: PMC must approve all API changes. No changes are to be released without prior approval and associated bug report.
Notification requirements: None.
Extra checking requirements: None. (However extra checking is always a good idea.)
June 12-17
contributions to RC3
Focus: Serious defects only; documentation.
Fix approval: Component lead plus one other component lead must approve all work on a component. No changes are to be released without prior approval and associated bug report tagged 3.0RC3. (Ongoing changes to component documentation do not require special approval.)
API change approval: PMC must approve all API changes. No changes are to be released without prior approval and associated bug report.
Notification requirements: Announce bug numbers of intended non-doc changes to platform-releng-dev@eclipse.org mailing list.
Extra checking requirements: Additional committer must check all code changes prior to release. Person who reported bug should mark the bug as verified once they have retested.
June 19-24
contributions to RC4
Focus: Serious defects only; documentation.
Fix approval: Component lead plus two other component leads must approve all non-doc work on a component. In addition, any component lead can veto a change with cause. No changes are to be released without associated bug report  tagged 3.0RC4 including risk assessment and prior approvals. (Ongoing changes to component documentation do not require special approval.)
API change approval: PMC must approve all API changes. No changes are to be released without prior approval and associated bug report.
Notification requirements: Announce bug numbers of intended non-doc changes to platform-releng-dev@eclipse.org mailing list.
Extra checking requirements: Two additional committers must check all code changes prior to release. Person who reported bug should mark the bug as verified once they have retested.