#40 document upgrades + move version prefix to a separate page
Merged by asamalik. Opened by asamalik.
fedora-docs/ asamalik/modularity upgrades-doc  into  master

Download 40.patch

Documenting how upgrades work — considering standalone packages, modular packages, and hotfixes.

As discussed in the recent WG meeting.

I've also moved a bit of existing content describing modular version prefixes into its own page as it didn't quite fit onto the page discussing upgrades.

I would replace "RPMS" with "RPMs", as "s" isn't part of the acronym.

Note that we inspect the target modulemd rather than the current one. If the package name is no longer provided by any modules in the target state, updating to ursine is valid.

In addition to prefixing module versions we also include the platform stream in the %dist tag to ensure the packages also have a clean upgrade path. I don't have a specific example of what this will look like in Fedora, however.

I would replace "RPMS" with "RPMs", as "s" isn't part of the acronym.

That's a typo, thanks for noticing.

Note that we inspect the target modulemd rather than the current one. If the package name is no longer provided by any modules in the target state, updating to ursine is valid.

Very good point, I'll mention that explicitly.

In addition to prefixing module versions we also include the platform stream in the %dist tag to ensure the packages also have a clean upgrade path. I don't have a specific example of what this will look like in Fedora, however.

That's actually a part of the file I'm moving as part of this PR.

1 new commit added

  • PR feedback on upgrade paths

Pull-Request has been merged by asamalik

Metadata