From 433feab25638b72810d0115eed93b3cf4c8dad3b Mon Sep 17 00:00:00 2001 From: Otto Liljalaakso Date: Sep 24 2022 18:48:44 +0000 Subject: Import Package Rename Policy Package Maintainer Docs currently contain page "Package Rename Process", which mainly contains normative policy statements. Such rules should come from a FESCo policy. It looks like that page was always intended to contain a FESCo policy, and is simply currently stored in the wrong place. Moving the policy to FESCo docs, so that going forward, it can managed as a proper policy. Grammar, formatting and links are slightly modified to correct errors and match style of other FESCo policies. The substance is not changed. --- diff --git a/fesco/modules/ROOT/nav.adoc b/fesco/modules/ROOT/nav.adoc index f97ec17..fad5eae 100644 --- a/fesco/modules/ROOT/nav.adoc +++ b/fesco/modules/ROOT/nav.adoc @@ -17,6 +17,7 @@ ** xref:Policy_for_orphan_and_retired_packages.adoc[Policy for orphan and retired packages] ** xref:Provenpackager_policy.adoc[Provenpackager policy] ** xref:Package_review_policy.adoc[Package review policy] +** xref:Package_rename_policy.adoc[Package rename policy] ** xref:SIG_policy.adoc[SIG policy] ** xref:Who_is_allowed_to_modify_which_packages.adoc[Who is allowed to modify which packages] ** xref:Third_Party_Repository_Policy.adoc[Third party repository policy] diff --git a/fesco/modules/ROOT/pages/Package_rename_policy.adoc b/fesco/modules/ROOT/pages/Package_rename_policy.adoc new file mode 100644 index 0000000..51e0f26 --- /dev/null +++ b/fesco/modules/ROOT/pages/Package_rename_policy.adoc @@ -0,0 +1,28 @@ += Package Rename Policy + +For a variety of reasons it may become necessary to rename a package in Fedora. +This page contains the policy that must be followed when such an event occurs. + +[#re_review_required] +== Re-review required + +When you wish to rename a package, you must request a re-review of your package, +as described in xref:Package_review_policy.adoc[Package Review Policy]. +In this review request, +you must state that this is a re-review request for a package rename, +including the old package name. +The reviewer of the package must explicitly acknowledge this fact. + +The reviewer must check the package for the proper Obsoletes and Provides +as specified in Packaging Guidelines section +xref:packaging-guidelines::index.adoc#renaming-or-replacing-existing-packages[Renaming/Replacing or Removing Existing Packages]. +They must explicitly acknowledge that they have done so. +A package rename without a clean upgrade path must not be accepted. + +[#after_the_review] +== After the review + +After the review has been completed, +renamed package must be imported into dist-git as a new package. +Old package can then be retired following the +xref:package-maintainers::Package_Retirement_Process.adoc[Package Retirement Process].