From bd5a9ba291499b8510316c365d3680e8addbe65f Mon Sep 17 00:00:00 2001 From: Otto Liljalaakso Date: Jan 14 2023 05:56:42 +0000 Subject: Recommend better method for orphaning Orphaning the package via giving it to the orphan user does not allow setting a reason for orphaning. That information is useful for potential new maintainers. Recommend the use of the Orphan button instead, which allows setting the reason. Also, recommend reading those notices when considering unorphaning. Also, mention that assigning bugzilla tickets to/from the orphan user is automatic. Fixes #103 --- diff --git a/modules/ROOT/pages/Package_Orphaning_Process.adoc b/modules/ROOT/pages/Package_Orphaning_Process.adoc index 4543631..10d83a4 100644 --- a/modules/ROOT/pages/Package_Orphaning_Process.adoc +++ b/modules/ROOT/pages/Package_Orphaning_Process.adoc @@ -6,39 +6,32 @@ as specified in xref:fesco::Policy_for_orphan_and_retired_packages.adoc[Policy f [#orphaning_procedure] == Orphaning Procedure -. If the package has co-maintainers, contact them +. (Optional) 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. + 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.` ++ +If somebody wants to take the package, +skip the rest of the procedure and give it to them as follows: -. 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). +.. Remove yourself under _Users and Groups_, +unless you want to remain as a co-maintainer. -. For completeness, -under the _Users and Groups_ section, -remove yourself from the list as well. +.. Reset your watch status, +unless you still want to be notified about new package bugs. -. Also reset your watch status -if you do not want to be CC'ed on new package bugs. +. Click the _✋ Orphan_ button on the left, fill requested information, and click _Update_. -. If the package was given to the `orphan` user, -announce on the https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/[devel mailing list] +. Announce on the https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/[devel mailing list] which package you orphaned, so that others have a chance to take over as maintainer. -. Reassign the package's tickets to the orphan user, -`extras-orphan@fedoraproject.org`. - After completing these steps, the package is orphaned. +Package's open bug reports are automatically assigned to the orphan user, +`extras-orphan@fedoraproject.org`. If nobody takes over the orphan package in six weeks, it is automatically retired by https://docs.pagure.org/releng/[Release Engineering]. @@ -50,7 +43,9 @@ by any interested packager at any time. They then become responsible for the package. . Check why the package was orphaned -by looking for the email at https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/[devel]. +by checking the note on the left menu of the package's main page +at https://src.fedoraproject.org/[Package Sources], +and looking for the email at https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/[devel]. . Announce on https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/[devel] which packages you want to take over. @@ -63,7 +58,7 @@ https://pagure.io/releng/new_issue?template=package_unorphan&title=Unorphan%20%3 stating which package you want to claim and that the button did not work. -. Reassign and claim all open bug reports for the package in Bugzilla. +All open bug reports for the package in Bugzilla are automatically reassigned to you. If you are not in the packager group yet, but want to claim ownership of an orphaned package,