Skip to content

Commit fde9eb6

Browse files
committed
Adjust the deprecation policy to be time based
1 parent f34172c commit fde9eb6

File tree

2 files changed

+10
-9
lines changed

2 files changed

+10
-9
lines changed

docs/development.rst

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -195,19 +195,19 @@ reworked and resubmitted for the next release.
195195
Deprecation Policy
196196
==================
197197

198-
Any change to pip that removes or significantly alters user-visible behaviour
198+
Any change to pip that removes or significantly alters user-visible behavior
199199
that is described in the pip documentation will be deprecated for a minimum of
200-
one released version before the change occurs. Deprecation will take the form of
201-
a warning being issued by pip when the feature is used. Longer deprecation
202-
periods, or deprecation warnings for behaviour changes that would not normally
203-
be covered by this policy, are also possible depending on circumstances, but
204-
this is at the discretion of the pip developers.
200+
6 months before the change occurs. Deprecation will take the form of a warning
201+
being issued by pip when the feature is used. Longer deprecation periods, or
202+
deprecation warnings for behavior changes that would not normally be covered by
203+
this policy, are also possible depending on circumstances, but this is at the
204+
discretion of the pip developers.
205205

206206
Note that the documentation is the sole reference for what counts as agreed
207-
behaviour. If something isn't explicitly mentioned in the documentation, it can
207+
behavior. If something isn't explicitly mentioned in the documentation, it can
208208
be changed without warning, or any deprecation period, in a pip release.
209209
However, we are aware that the documentation isn't always complete - PRs that
210-
document existing behaviour with the intention of covering that behaviour with
210+
document existing behavior with the intention of covering that behavior with
211211
the above deprecation process are always acceptable, and will be considered on
212212
their merits.
213213

news/deprecation.process

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
1-
Formally document our deprecation process
1+
Formally document our deprecation process as a minimum of 6 months of deprecation
2+
warnings.

0 commit comments

Comments
 (0)