#47 Update 'managing defaults and fedora changes'
Merged 8 months ago by asamalik. Opened 8 months ago by asamalik.
fedora-docs/ asamalik/modularity default-changes  into  master

@@ -1,14 +1,17 @@ 

  = 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. Setting or changing the default stream or the default installation profile requires a Fedora Change request, and it is only allowed in between Fedora releases.

+ 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 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]. You also need to https://fedoraproject.org/wiki/Changes/Policy#For_developers[submit 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].

  

- Setting or changing default stream of a module will be considered based on the following rules:

+ Please note that if the module stream masks part of the Traditional RPM repos (e.g it replaces an existing RPM or it introduces a non-trivial set of conflicts) it may not be made a default stream without the express permission of FESCo. Release Engineering will be responsible for escalating any PR that is questionable on this point to FESCo for a final decision.

  

- * If the module stream does not mask any part of the Traditional RPM repos, it may be set as a default stream. For example, any module that is entirely a leaf or one that fulfills the function of a package moved from the traditional repos into the modular repos (e.g. `nodejs:8` might replace the `nodejs` traditional package)

- * If the module stream masks part of the Traditional RPM repos (e.g it replaces an existing RPM or it introduces a non-trivial set of conflicts) it may not be made a default stream without the express permission of FESCo. Release Engineering will be responsible for escalating any PR that is questionable on this point to FESCo for a final decision.

Updating the 'managing defaults and fedora changes' page based on https://tree.taiga.io/project/modularity-wg/epic/35

1 new commit added

  • typo
8 months ago

I'd rewrite this sentence as "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:"

"Changes of the default stream of a module are not permitted within a released Fedora without the approval of FESCo."

This bullet is difficult to parse. Maybe:
"4. Moving a package from traditional to a default module is permitted within a stable release, provided that the default stream provides the equivalent functionality. This does not require filing a Change.

Add "Please specify which releases of Fedora should have which streams/profiles by default in the initial ticket".

Thanks for the feedback!

1 new commit added

  • better phrasing in managing defaults
8 months ago

Pull-Request has been merged by asamalik

8 months ago
Metadata