FreezeExceptionProcess

Revision 19 as of 2007-09-09 20:35:25

Clear message

As with most rules, there are occasional exceptions to the restrictions imposed by the various stages of the Ubuntu release process. These exceptions are granted by the release team based on information provided by the developer who proposes the change.

TableOfContents()

General Instructions

Requests for freeze exceptions for main should be filed as bugs in launchpad against the relevant package (or just "Ubuntu" if the package is not available yet). Once the bug is filed and the necessary information is available, subscribe the ubuntu-release team. All freeze exceptions must include the following information, in order to provide them with enough information to weigh the risk of regressions against the benefit of the changes:

  • A description of the proposed changes, with sufficient detail to estimate their potential impact on the distribution
  • A rationale for the exception, explaining the benefit of the change
  • Any additional information which would be helpful in considering the decision

UpstreamVersionFreeze (UVF) Exceptions - UVFe

A request for an exception to the UpstreamVersionFreeze should demonstrate that the proposed new upstream release is appropriate for the current phase of the Ubuntu release process. For example, if the current freeze guidelines allow only bug fixes, the proposed upstream release should contain only bug fixes. Reviewing the upstream changes with a third party helps to ensure that no unexpected changes are introduced which could disrupt the release process.

An UpstreamVersionFreeze exception request must include at least the following additional details:

  • An excerpt from the upstream changelog and/or release notes listing (only) the changes relative to the current version in Ubuntu
  • If the upstream version contains changes which require exceptions to other freeze guidelines, additional information should be provided according to the instructions below.

FeatureFreeze Exceptions

A request for an exception to FeatureFreeze should demonstrate that the benefit of new functionality, or the total benefit of a new upstream release which includes it, outweighs the risk of regressions and other potential disruption of the release process.

Exception requests must include the following additional details:

  • diffstat output showing the magnitude of code changes relative to the current version in Ubuntu

  • An explanation of the testing which has been performed on the new version in Ubuntu, including verification that the new package:
    • Builds
    • Installs
    • Does not break packages which depend on it, or that corresponding updates have been prepared

DeepFreeze Exceptions

During DeepFreeze periods, extreme caution is exercised when considering freeze exceptions, as a regression could cause a deadline to be missed, or a build to receive less testing than desired. A request for an exception must demonstrate strong rationale and minimal risk for the update to be considered.

Exception requests must include the following additional details:

  • A complete debdiff of the proposed upload

Exceptions for Universe/Multiverse

Upstream Version Freeze

If you want to get UVF exception for something, please

  • [https://launchpad.net/ubuntu/+filebug file a bug]

  • state the reason why you feel it is necessary
    • (other bugs it fixes, etc.)
  • attach (as files)
    • diffstat of the upstream tarballs

      diff -ruN <package>-{old-version,new-version} | diffstat > diffstat.txt
    • diff of the Upstream ChangeLog (not debian/changelog)

      diff -u <package>-{old-version,new-version}/ChangeLog > changelog.diff
    • note that the ChangeLog sometimes is called CHANGES, is missing or the tarball merely has a NEWS file.

    • this does not mean debian/changelog

    • the NEWS file, if you think that this information helps reviewing your request (true for most gnome packages)

    • build-/install-log (as files)
      • pbuilder has the --logfile option.

  • subscribe (not assign) it to the 'motu-uvf' team.

Please note that we expect requesters to have an updated package already prepared and tested! You will need this anyway to provide proper diffstats and buildlogs.

Once one of the [https://launchpad.net/~motu-uvf team members] marks the bug as Confirmed you can proceed with uploading.

References:

New Packages Freeze

The motu-uvf team will consider exceptions, where additions of packages are worthwhile (up until BetaFreeze). Please note: the motu-uvf team will not review the package for you. You should have followed ["MOTU/Packages/New/Policy"] before asking for an exception.

Process:

  • Follow ["MOTU/Packages/New/Policy"].
  • File a bug, attach the source package to it (or link to it).
  • subscribe (not assign) the bug to motu-uvf.

  • State why the addition of the package should get considered.

Decision: ["MOTU/Council/Meetings/2007-02-23"].

Hard Freeze

During the last week of development before the release, all uploads need to get approved by the release team. Usually they ask a MOTU team for approval of Universe and Multiverse packages.

Process:

  • Either file a bug with the debdiff and assign it to motu-uvf and get approval for it.

  • Or ask a member of the motu-uvf [http://launchpad.net/~motu-uvf team] on IRC of approval for the debdiff.

Decision: ["MOTU/Council/Meetings/2007-02-23"].


["CategoryProcess"]