|
|
| (10 intermediate revisions by 5 users not shown) |
| Line 1: |
Line 1: |
| {{autolang|base=yes}}
| | {{admon/warning |This page has been moved out of the wiki. The current version of this document is located at https://docs.fedoraproject.org/en-US/package-maintainers/Package_Orphaning_Process/ Please 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 — https://src.fedoraproject.org/rpms/PACKAGE_NAME/settings.
| |
| # After the first step is finished, visit your package's Pagure repository, and navigate to the settings tab.
| |
| # 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 [https://lists.fedoraproject.org/mailman/listinfo/devel 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 [https://lists.fedoraproject.org/mailman/listinfo/devel devel].
| |
| # [https://fedoraproject.org/wiki/Infrastructure/WhatHappenedToPkgdb#How_do_I_adopt_an_orphaned_package_or_unretire_a_package.3F_.28TODO.29 PkgDB was recently deprecated]. For now, you will need to [https://pagure.io/releng/issues submit a ticket to the Release Engineering team], stating which package you want to claim.
| |
| # Also announce on [https://lists.fedoraproject.org/mailman/listinfo/devel 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 two 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 [https://lists.fedoraproject.org/mailman/listinfo/devel devel mailing list] or emailing the former maintainer. You can also check dead.package in the SCM (url like: [https://src.fedoraproject.org/rpms/system-config-network/blob/master/f/dead.package https://src.fedoraproject.org/rpms/'''package_name_here'''/blob/master/f/dead.package])
| |
| # Announce on [https://lists.fedoraproject.org/mailman/listinfo/devel 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 two 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 [https://pagure.io/releng/issues 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 ==
| |
| | |
| * [https://src.fedoraproject.org/user/orphan A list of currently orphaned and/or retired packages]
| |
| | |
| == References ==
| |
| * https://fedorahosted.org/fesco/ticket/1332
| |
| * http://meetbot.fedoraproject.org/fedora-meeting/2014-08-27/fesco.2014-08-27-17.00.html
| |
| === EPEL ===
| |
| * https://fedorahosted.org/epel/ticket/4
| |
| * http://meetbot.fedoraproject.org/epel/2014-10-31/epel.2014-10-31-20.01.html
| |
| {{Anchor|core}}
| |
| | |
| [[Category:Package Maintainers]] [[Category:Policy]]
| |
