From Fedora Project Wiki

(two weeks → eight weeks (
(Replaced content with "{{admon/warning |This page has been moved out of the wiki. The current version of this document is located at")
Tag: Replaced
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{admon/warning |This page has been moved out of the wiki. The current version of this document is located at update your bookmarks.}}
== About Orphan and Retired (Deprecated) Packages ==
When Fedora maintainers do not want or are not able to maintain a package any
longer, they can orphan or [[How_to_remove_a_package_at_end_of_life|retire]] the
package. When they think that the package is still useful for Fedora, they
should orphan it. Then other maintainers that are interested in maintaining it,
can take ownership of this package. In case the package is no longer useful for
Fedora, e.g. because it was renamed, upstream does not exist anymore, then it
should be retired. But this is only possible for development releases such as Branched or Rawhide.
Orphaned packages remain in stable releases and are the responsibility of the collective packaging community to maintain.
{{admon/warning|Retiring packages|Orphan packages will be retired if they remain orphaned for six weeks.}}
{{admon/warning|When to orphan and retire your packages|We encourage maintainers considering orphaning their packages to do it as early in the development cycle as possible. Shortly after the prior release is branched is a good time.}}
== Orphaning Procedure ==
# If the package has co-maintainers, contact them to ask whether one of them wants to take over ownership of the package. This step is optional. If no co-maintainer can be found to take over the package, the package should be given to the "orphan" user.<BR><BR>The current list of maintainers can be found in the "Users & Groups" tab of the setting for the package repo. The URL will look something like this —
# After the first step is finished, go again to the settings tab for your package's Pagure repository. Navigate down to the ''Give Project'' section and "give" the project to the new maintainer or the "orphan" user (in case no new maintainer was selected).
# For completeness, under the ''Users and Groups'' section, remove yourself from the list as well.
# Also reset your watch status if you do not want to be CC'ed on new package bugs.
# If the package was given to the "orphan" user, announce on [ devel] which package you orphaned, so that others have a chance to take over as maintainer.
== Claiming Ownership of an Orphaned Package ==
# Check why the package was orphaned by looking for the email to [ devel].
# [ PkgDB was recently deprecated]. For now, you will need to [ submit a ticket to the Release Engineering team], stating which package you want to claim.
# Also announce on [ devel] which packages you want to take over.
# When all the above is complete and Release Engineering has made you the new package owner, reassign and claim all open bug reports for the package in Bugzilla.
== Claiming Ownership of a Retired Package ==
{{admon/warning|Un-Retiring long-time retired packages|Packages that are retired for Rawhide for more than 8 weeks need to be reviewed again before they can be un-retired. This is also true for EPEL-only packages.}}
If you really want to maintain a retired package, you need to be aware that
if upstream is dead, fixing release critical bugs, etc becomes your
responsibility. This is to ensure the high quality and standards of packaging
remain for Fedora package collection. There may be additional issues with
retired packages. If possible, consult with the former maintainer for more information.
The process is a bit different from unorphaning a package
# See if you can figure out why the package was retired including searching for information about orphaned packages on [ devel mailing list] or emailing the former maintainer. You can also check dead.package in the SCM (url like: ['''package_name_here'''/blob/master/f/dead.package])
# Announce on [ devel]  which packages you would like to become the owner of.
# Retired Fedora packages (master/devel/rawhide branch retired) require a re-review if they are retired for more than eight weeks or if there is no previous review of the package. Submit a review request (a new bugzilla ticket) and have the package approved by a reviewer as if it were new to Fedora. See [[Package Review Process|the package review process]] for more information. To unretire a EPEL branch if the package is still in Fedora, no re-review is required.
# Request unretirement by filing a [ releng ticket]. Specify all branches that need to be un-retired (inlcuding "master" for Rawhide, unless it is for EPEL only) and include the link to re-review. In this ticket, request that the [[ReleaseEngineering|Release Engineering team]] unblock the package for the releases that the package should be un-retired for. In this request, clearly specify which branches should be unblocked.
# Restore the contents in GIT and prepare a new build and update (if necessary).
== Lists of Orphan and Retired Packages ==
*  [ A list of currently orphaned and/or retired packages]
== References ==
=== EPEL ===
[[Category:Package Maintainers]] [[Category:Policy]]

Latest revision as of 06:09, 7 September 2021

This page has been moved out of the wiki. The current version of this document is located at Please update your bookmarks.