Orbit/Promotion, Release, and Retention Policies
= UNDER REVIEW =
Orbit itself does not have releases, per se, since the 3rd party jars that are bundled have already been released. But, we will still use the Eclipse Simultaneous Release rhythm to set deadlines for ourselves and promote and retain bundles.
An Orbit milestone will be considered the same as the base Eclipse platform. This is a statement of time, as opposed to content, since for anyone else in the Simultaneous Release to use an Orbit Bundle, it would have to be ready (and final) at least a week or two before their milestone deadline.
Our continuous builds produce bundles ("builds") in the committers area. Their purpose is for the committers to have something to see or download and confirm all is as they expect it to be. These builds are often short lived and can be deleted without notice.
Once per week, currently by Monday noon (Eastern time), the latest continuous build will be copied over to the downloads area. These are similar or analogous to weekly Integration Builds, and will be retained in place until the Milestone release.
Once per milestone, (roughly simultaneous with the platform's milestone), the bundles from the latest weekly build will be copied to the bundles area. This is to be considered the final home for the bundles added here. That is, these "milestone" bundles should not normally have to be re-built. In case they do, they will have different qualifiers in the fourth field. As a matter of policy, we will retain up to 3 qualified versions of the same bundle. (And, we anticipate it being very rare to hit that limit).
'Issue: ' This permanent home for the bundles will not have "timestamp" directories, so it is easier to specify a permanent URL, write scripts, etc. The issue is that while these can currently be easily obtained one by one, but we have not yet decided what, if any, archive or update files to create for these "final" bundles.
The downloads area and bundles area are mirrored, so we will have a retention policy for bundles in general, to be sure it doesn't grow too large over the years. By policy, we will retain up to 3 versions of some bundle and after that, the older versions will be moved to the archive area. These "versions" do not include qualified versions, but means, for example, Xerces 2.8.0, 2.8.1, and 2.9.0. Once 2.9.1 was put in the repository, 2.8.0 would be archived. Eclipse Projects may request waivers to this policy if needed for some specific cases.