From 8385cb5250e72129210b9b3f4f78665325741003 Mon Sep 17 00:00:00 2001 From: Hugo van Kemenade Date: Sun, 13 Sep 2020 10:14:03 +0300 Subject: [PATCH 1/4] Document fast-track deprecation policy --- docs/html/development/release-process.rst | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/html/development/release-process.rst b/docs/html/development/release-process.rst index 44197955e8e..82358b3ebc1 100644 --- a/docs/html/development/release-process.rst +++ b/docs/html/development/release-process.rst @@ -38,11 +38,17 @@ Deprecation Policy Any change to pip that removes or significantly alters user-visible behavior that is described in the pip documentation will be deprecated for a minimum of -6 months before the change occurs. Deprecation will take the form of a warning +6 months before the change occurs. + +Certain changes may be fast tracked and have a deprecation period of 3 months. +This requires at least two members of the pip team to be in favor of doing so, +and no pip maintainers opposing. + +Deprecation will take the form of a warning being issued by pip when the feature is used. Longer deprecation periods, or deprecation warnings for behavior changes that would not normally be covered by this policy, are also possible depending on circumstances, but this is at the -discretion of the pip developers. +discretion of the pip maintainers. Note that the documentation is the sole reference for what counts as agreed behavior. If something isn't explicitly mentioned in the documentation, it can From b6fb8b80e247c096d0f96b5980c1f57f3e53902e Mon Sep 17 00:00:00 2001 From: Hugo van Kemenade Date: Sun, 13 Sep 2020 10:15:34 +0300 Subject: [PATCH 2/4] Reflow paragraph --- docs/html/development/release-process.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/html/development/release-process.rst b/docs/html/development/release-process.rst index 82358b3ebc1..66ff3ca7c51 100644 --- a/docs/html/development/release-process.rst +++ b/docs/html/development/release-process.rst @@ -44,11 +44,11 @@ Certain changes may be fast tracked and have a deprecation period of 3 months. This requires at least two members of the pip team to be in favor of doing so, and no pip maintainers opposing. -Deprecation will take the form of a warning -being issued by pip when the feature is used. Longer deprecation periods, or -deprecation warnings for behavior changes that would not normally be covered by -this policy, are also possible depending on circumstances, but this is at the -discretion of the pip maintainers. +Deprecation will take the form of a warning being issued by pip when the +feature is used. Longer deprecation periods, or deprecation warnings for +behavior changes that would not normally be covered by this policy, are also +possible depending on circumstances, but this is at the discretion of the pip +maintainers. Note that the documentation is the sole reference for what counts as agreed behavior. If something isn't explicitly mentioned in the documentation, it can From 2f0fa53e95edceb5b45d7cd17cb508cc0aaed49f Mon Sep 17 00:00:00 2001 From: Hugo van Kemenade Date: Sun, 13 Sep 2020 21:03:16 +0300 Subject: [PATCH 3/4] Add news fragment --- news/8417.removal | 1 + 1 file changed, 1 insertion(+) create mode 100644 news/8417.removal diff --git a/news/8417.removal b/news/8417.removal new file mode 100644 index 00000000000..8f280b535c3 --- /dev/null +++ b/news/8417.removal @@ -0,0 +1 @@ +Document that certain removals can be fast tracked. From 294995bc47961b0d948e50521fc0a5ebfebab71b Mon Sep 17 00:00:00 2001 From: Hugo van Kemenade Date: Mon, 14 Sep 2020 23:00:48 +0300 Subject: [PATCH 4/4] Fix typo --- docs/html/development/release-process.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/html/development/release-process.rst b/docs/html/development/release-process.rst index 66ff3ca7c51..ebba1325864 100644 --- a/docs/html/development/release-process.rst +++ b/docs/html/development/release-process.rst @@ -16,7 +16,7 @@ with version numbers. Our release months are January, April, July, October. The release date within that month will be up to the release manager for that release. If there are no changes, then that release month is skipped and the next release will be -3 month later. +3 months later. The release manager may, at their discretion, choose whether or not there will be a pre-release period for a release, and if there is may extend that