From 63208cbd791937d37c710a0aa9bcd737662bef03 Mon Sep 17 00:00:00 2001 From: JosephParampathu <88171669+JosephParampathu@users.noreply.github.com> Date: Tue, 26 Apr 2022 23:09:37 -0700 Subject: [PATCH 1/4] DOC: GH27557 Updates Python support documentation to match NumPy NEP 29 --- doc/build/html/development/policies.html | 462 +++++++++++++++++++++++ 1 file changed, 462 insertions(+) create mode 100644 doc/build/html/development/policies.html diff --git a/doc/build/html/development/policies.html b/doc/build/html/development/policies.html new file mode 100644 index 0000000000000..80dbe2db24cc8 --- /dev/null +++ b/doc/build/html/development/policies.html @@ -0,0 +1,462 @@ + + + + + + + + + Policies — pandas 1.5.0.dev0+697.gf9762d8f52 documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + + +
+
+ + +
+
+
+
+
+ + + + +
+ + +
+ +
+ On this page +
+ + +
+ +
+ +
+ + +
+ + + + + + +
+ +
+ +
+

Policies#

+
+

Version policy#

+
+

Changed in version 1.0.0.

+
+

pandas uses a loose variant of semantic versioning (SemVer) to govern +deprecations, API compatibility, and version numbering.

+

A pandas release number is made up of MAJOR.MINOR.PATCH.

+

API breaking changes should only occur in major releases. These changes +will be documented, with clear guidance on what is changing, why it’s changing, +and how to migrate existing code to the new behavior.

+

Whenever possible, a deprecation path will be provided rather than an outright +breaking change.

+

pandas will introduce deprecations in minor releases. These deprecations +will preserve the existing behavior while emitting a warning that provide +guidance on:

+
    +

  • How to achieve similar behavior if an alternative is available

    • +

  • The pandas version in which the deprecation will be enforced.

    • +
+

We will not introduce new deprecations in patch releases.

+

Deprecations will only be enforced in major releases. For example, if a +behavior is deprecated in pandas 1.2.0, it will continue to work, with a +warning, for all releases in the 1.x series. The behavior will change and the +deprecation removed in the next major release (2.0.0).

+
+

Note

+

pandas will sometimes make behavior changing bug fixes, as part of +minor or patch releases. Whether or not a change is a bug fix or an +API-breaking change is a judgement call. We’ll do our best, and we +invite you to participate in development discussion on the issue +tracker or mailing list.

+
+

These policies do not apply to features marked as experimental in the documentation. +pandas may change the behavior of experimental features at any time.

+
+
+

Python support#

+

pandas mirrors the NumPy guidelines for Python support.

+
+
+ + +
+ + + +
+ + +
+

previous

+

Developer

+
+ + +
+

next

+

Roadmap

+
+ + +
+ +
+ + +
+
+ + + + + + From bd0c26aea3933aa514a051e9799cbb33c36ec191 Mon Sep 17 00:00:00 2001 From: JosephParampathu <88171669+JosephParampathu@users.noreply.github.com> Date: Wed, 27 Apr 2022 14:24:54 -0700 Subject: [PATCH 2/4] DOC: GH27557 Updates Python support development docstring to match NumPy NEP 29 --- doc/source/development/policies.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/source/development/policies.rst b/doc/source/development/policies.rst index f8e6bda2085d8..c724969709208 100644 --- a/doc/source/development/policies.rst +++ b/doc/source/development/policies.rst @@ -51,7 +51,7 @@ pandas may change the behavior of experimental features at any time. Python support ~~~~~~~~~~~~~~ -pandas will only drop support for specific Python versions (e.g. 3.6.x, 3.7.x) in -pandas **major** or **minor** releases. +pandas mirrors the `NumPy guidelines for Python support `_. + .. _SemVer: https://semver.org From 4561ec03445c14813216dd5224d93474e4705c61 Mon Sep 17 00:00:00 2001 From: JosephParampathu <88171669+JosephParampathu@users.noreply.github.com> Date: Wed, 27 Apr 2022 14:33:09 -0700 Subject: [PATCH 3/4] DOC: GH27557 Updates Python support development docstring, reformatted link --- doc/source/development/policies.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/development/policies.rst b/doc/source/development/policies.rst index c724969709208..d75262c08dfd6 100644 --- a/doc/source/development/policies.rst +++ b/doc/source/development/policies.rst @@ -51,7 +51,7 @@ pandas may change the behavior of experimental features at any time. Python support ~~~~~~~~~~~~~~ -pandas mirrors the `NumPy guidelines for Python support `_. +pandas mirrors the `NumPy guidelines for Python support `__. .. _SemVer: https://semver.org From dbea63d052f468be6b516ef4856243d89f213fad Mon Sep 17 00:00:00 2001 From: JosephParampathu <88171669+JosephParampathu@users.noreply.github.com> Date: Wed, 27 Apr 2022 21:22:42 -0700 Subject: [PATCH 4/4] Delete policies.html Removed policies.html file per request from jreback --- doc/build/html/development/policies.html | 462 ----------------------- 1 file changed, 462 deletions(-) delete mode 100644 doc/build/html/development/policies.html diff --git a/doc/build/html/development/policies.html b/doc/build/html/development/policies.html deleted file mode 100644 index 80dbe2db24cc8..0000000000000 --- a/doc/build/html/development/policies.html +++ /dev/null @@ -1,462 +0,0 @@ - - - - - - - - - Policies — pandas 1.5.0.dev0+697.gf9762d8f52 documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - -
-
- - -
-
-
-
-
- - - - -
- - -
- -
- On this page -
- - -
- -
- -
- - -
- - - - - - -
- -
- -
-

Policies#

-
-

Version policy#

-
-

Changed in version 1.0.0.

-
-

pandas uses a loose variant of semantic versioning (SemVer) to govern -deprecations, API compatibility, and version numbering.

-

A pandas release number is made up of MAJOR.MINOR.PATCH.

-

API breaking changes should only occur in major releases. These changes -will be documented, with clear guidance on what is changing, why it’s changing, -and how to migrate existing code to the new behavior.

-

Whenever possible, a deprecation path will be provided rather than an outright -breaking change.

-

pandas will introduce deprecations in minor releases. These deprecations -will preserve the existing behavior while emitting a warning that provide -guidance on:

-
    -

  • How to achieve similar behavior if an alternative is available

    • -

  • The pandas version in which the deprecation will be enforced.

    • -
-

We will not introduce new deprecations in patch releases.

-

Deprecations will only be enforced in major releases. For example, if a -behavior is deprecated in pandas 1.2.0, it will continue to work, with a -warning, for all releases in the 1.x series. The behavior will change and the -deprecation removed in the next major release (2.0.0).

-
-

Note

-

pandas will sometimes make behavior changing bug fixes, as part of -minor or patch releases. Whether or not a change is a bug fix or an -API-breaking change is a judgement call. We’ll do our best, and we -invite you to participate in development discussion on the issue -tracker or mailing list.

-
-

These policies do not apply to features marked as experimental in the documentation. -pandas may change the behavior of experimental features at any time.

-
-
-

Python support#

-

pandas mirrors the NumPy guidelines for Python support.

-
-
- - -
- - - -
- - -
-

previous

-

Developer

-
- - -
-

next

-

Roadmap

-
- - -
- -
- - -
-
- - - - - -