mirror of https://github.com/pypa/pip
Merge pull request #8873 from hugovk/docs-3-months-deprecation
This commit is contained in:
parent
e832878f3f
commit
e7e62d8f75
|
@ -16,7 +16,7 @@ with version numbers.
|
||||||
Our release months are January, April, July, October. The release date within
|
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
|
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
|
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
|
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
|
will be a pre-release period for a release, and if there is may extend that
|
||||||
|
@ -38,11 +38,17 @@ Deprecation Policy
|
||||||
|
|
||||||
Any change to pip that removes or significantly alters user-visible behavior
|
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
|
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.
|
||||||
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
|
Certain changes may be fast tracked and have a deprecation period of 3 months.
|
||||||
this policy, are also possible depending on circumstances, but this is at the
|
This requires at least two members of the pip team to be in favor of doing so,
|
||||||
discretion of the pip developers.
|
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.
|
||||||
|
|
||||||
Note that the documentation is the sole reference for what counts as agreed
|
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
|
behavior. If something isn't explicitly mentioned in the documentation, it can
|
||||||
|
|
|
@ -0,0 +1 @@
|
||||||
|
Document that certain removals can be fast tracked.
|
Loading…
Reference in New Issue