Skip to content

DOC: Make ExtensionArray not experimental #47225

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jun 10, 2022
Merged

DOC: Make ExtensionArray not experimental #47225

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3e2a1a8
DOC: Make ExtensionArray not experimental
Dr-Irv Jun 4, 2022
c9a11e8
make experimental cut at v1.5
Dr-Irv Jun 6, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions doc/source/development/extending.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -74,10 +74,11 @@ applies only to certain dtypes.
Extension types
---------------

.. warning::
.. note::

The :class:`pandas.api.extensions.ExtensionDtype` and :class:`pandas.api.extensions.ExtensionArray` APIs are new and
experimental. They may change between versions without warning.
The :class:`pandas.api.extensions.ExtensionDtype` and :class:`pandas.api.extensions.ExtensionArray` APIs were
experimental prior to pandas 1.5. Starting with version 1.5, future changes will follow
the :ref:`pandas deprecation policy <policies.version>`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In practice we were already following that policy for earlier versions as well, but not sure if that nuance is important for the user (we could also say retro-actively that they were stable since 1.0, because I don't think we had breaking changes since then)


pandas defines an interface for implementing data types and arrays that *extend*
NumPy's type system. pandas itself uses the extension system for some types
Expand Down