From 5ce5ba4651cc38427d45fe1ae447bf51481bfe99 Mon Sep 17 00:00:00 2001 From: Adam Samalik Date: Jan 31 2019 12:14:18 +0000 Subject: better phrasing in managing defaults --- diff --git a/modules/ROOT/pages/making-modules/managing-defaults.adoc b/modules/ROOT/pages/making-modules/managing-defaults.adoc index dbd9012..84e9bb1 100644 --- a/modules/ROOT/pages/making-modules/managing-defaults.adoc +++ b/modules/ROOT/pages/making-modules/managing-defaults.adoc @@ -1,15 +1,15 @@ = Managing module defaults in Fedora -Setting or changing a *default stream* or a *default installation profile* of a module is in most cases similar to changing a major version of a package. The following rules apply: +Setting or changing a default stream or a default installation profile of a module constitutes a major behavior change as defined in the Fedora Updates Policy. The following rules apply: -1. Module stream defaults should be only changed in an upcoming Fedora release -2. Changes of stream defaults should be communicated by a Fedora Change based on the change's significance and its maintainer's best judgement. -3. No default stream changes mid-release are permitted. +1. Module stream defaults MUST be only changed in an upcoming Fedora release +2. Changes of stream defaults should be communicated by a Fedora Change based on the change's significance and its maintainer's best judgement. When in doubt, file a Change. +3. Changes of the default stream of a module are not permitted within a released Fedora without the approval of FESCo. 4. Introducing a new default stream not replacing any existing default stream or a traditional package is not considered a change. That means it can be done. == Setting or changing a default -Submit an issue to Fedora Release Engineering in https://pagure.io/releng/issues[pagure.io/releng]. Consider https://fedoraproject.org/wiki/Changes/Policy#For_developers[submiting a Fedora Change]. +Submit an issue to Fedora Release Engineering in https://pagure.io/releng/issues[pagure.io/releng]. Consider https://fedoraproject.org/wiki/Changes/Policy#For_developers[submiting a Fedora Change]. Please specify which releases of Fedora should have which streams/profiles by default in the initial ticket. To check the current defaults, have a look at the https://pagure.io/releng/fedora-module-defaults[fedora module defaults repository].