Changes Freeze Policy

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(Exception Process: Correct a typo)
m
 
(3 intermediate revisions by one user not shown)
Line 1: Line 1:
<!-- page was renamed from Releases/FeatureFreezePolicy
+
{{admon/tip|Ignoring the Changes Freeze|Introducing significant changes to Official Changes after Changes Freeze can result in your package being reverted or reduce the chances of receiving an exception}}
-->
+
  
{{admon/tip|Ignoring Feature Freeze|Introducing significant changes to Official Features after Feature Freeze can result in your package being reverted or reduce the chances of receiving an exception}}
+
Changes are accounted for at two different levels:
 
+
# Change page promotion and distro coordination -- see [[Changes/Policy| Fedora Release Planning Process]]
Features are accounted for at two different levels:
+
# Feature page promotion and distro coordination -- see [[Features/Policy| Fedora Feature Process]]
+
 
# Package level (continue reading)  
 
# Package level (continue reading)  
  
Once the ''Feature Freeze'' milestone is reached, all new features for the release should be:
+
Once the ''Changes Freeze'' milestone is reached, all new Changes for the release should be:
 
* substantially complete and in a ''testable'' state
 
* substantially complete and in a ''testable'' state
* ''enabled by default'' -- if so specified by the feature
+
* ''enabled by default'' -- if so specified by the chnage
  
In the Fedora development process, all new feature work is completed by ''Feature Freeze'' and tested during the test releases: Alpha and Beta.
+
In the Fedora development process, all new feature work is completed by ''Changes Freeze'' and tested during the test releases: Alpha and Beta.
  
 
== Some Example Do's and Don't's ==
 
== Some Example Do's and Don't's ==
  
After Feature Freeze, Fedora has certain expectations about what will be happening with your feature.  These expectations are based on needing to test your feature (package), test how other pieces of the distribution interact with your feature, and test the overall stability, look, and feel of the distribution.   
+
After Changes Freeze, Fedora has certain expectations about what will be happening with your Change.  These expectations are based on needing to test your Change (package), test how other pieces of the distribution interact with your feature, and test the overall stability, look, and feel of the distribution.   
  
This what we all expect ''post-Feature Freeze'':
+
This what we all expect ''post-Changes Freeze'':
  
 
* Do: Have something testable
 
* Do: Have something testable
Line 24: Line 21:
 
* Do: submit bugfixes
 
* Do: submit bugfixes
 
* '''Do not''': Continue to add new enhancements
 
* '''Do not''': Continue to add new enhancements
* '''Do not''': Enable the feature by default (if not already default at Feature Freeze)
+
* '''Do not''': Enable the change by default (if not already default at Changes Freeze)
 
* '''Do not''': Make changes that require other (dependent) software packages to make changes as well
 
* '''Do not''': Make changes that require other (dependent) software packages to make changes as well
  
Line 31: Line 28:
 
{{admon/caution|Ask First|Before checking in changes and building new packages, please request an exception first.  This saves everyone the time and mess of reverting a change if Release Engineering disagrees with the request.}}
 
{{admon/caution|Ask First|Before checking in changes and building new packages, please request an exception first.  This saves everyone the time and mess of reverting a change if Release Engineering disagrees with the request.}}
  
If you believe you have a good reason to ''break Feature Freeze.'' file a ticket with [https://fedorahosted.org/fesco/newtplticket FESCo]. Breaking ''Feature Freeze'' means making changes to your package other than simple bug fixes.   
+
If you believe you have a good reason to ''break Changes Freeze.'' file a ticket with [https://fedorahosted.org/fesco/newtplticket FESCo]. Breaking ''Changes Freeze'' means making changes to your package other than simple bug fixes.   
  
 
Please include the following information:  
 
Please include the following information:  

Latest revision as of 04:14, 9 July 2014

Idea.png
Ignoring the Changes Freeze
Introducing significant changes to Official Changes after Changes Freeze can result in your package being reverted or reduce the chances of receiving an exception

Changes are accounted for at two different levels:

  1. Change page promotion and distro coordination -- see Fedora Release Planning Process
  2. Package level (continue reading)

Once the Changes Freeze milestone is reached, all new Changes for the release should be:

  • substantially complete and in a testable state
  • enabled by default -- if so specified by the chnage

In the Fedora development process, all new feature work is completed by Changes Freeze and tested during the test releases: Alpha and Beta.

[edit] Some Example Do's and Don't's

After Changes Freeze, Fedora has certain expectations about what will be happening with your Change. These expectations are based on needing to test your Change (package), test how other pieces of the distribution interact with your feature, and test the overall stability, look, and feel of the distribution.

This what we all expect post-Changes Freeze:

  • Do: Have something testable
  • Do: Have the the feature significantly complete
  • Do: submit bugfixes
  • Do not: Continue to add new enhancements
  • Do not: Enable the change by default (if not already default at Changes Freeze)
  • Do not: Make changes that require other (dependent) software packages to make changes as well

[edit] Exception Process

Stop (medium size).png
Ask First
Before checking in changes and building new packages, please request an exception first. This saves everyone the time and mess of reverting a change if Release Engineering disagrees with the request.

If you believe you have a good reason to break Changes Freeze. file a ticket with FESCo. Breaking Changes Freeze means making changes to your package other than simple bug fixes.

Please include the following information:

  1. A description of what you want to change
  2. Rationale for why the change is important enough to be allowed in after the Feature Freeze.
  3. Impact of not accepting the the new package(s) at this point in the schedule.
  4. Information on what testing you've performed to mitigate risks introduced by replacing the existing package(s)

[edit] Exception Evaluation

FESCo will evaluate your request and provide feedback. This will generally be done in the ticket, and/or in a regular FESCo meeting.