[Doc]: Axes.inset_axes is still experimental

[rcomer]

Documentation Link

https://matplotlib.org/devdocs/api/_as_gen/matplotlib.axes.Axes.inset_axes.html#matplotlib.axes.Axes.inset_axes

Problem

I just noticed that Axes.inset_axes is still marked as experimental. It seems pretty well established to me, even recommended as a method for placing colorbars.

Suggested improvement

Is it time to remove the "experimental" warning?

[Snehaaa18]

Please assign this issue to me

[rcomer]

Hello @Snehaaa18, thank you for your enthusiasm, but we do not assign issues. Also I would like to wait for other maintainers to comment whether it should be done before anyone makes the change.

[timhoffm]

I vote for dropping the experimental flag. The API is consistent and simple enough. And it's been around long enough that we can expect reasonable adoption so that any incompatible changes should better run through a deprecation cycle, whether we've still formally marked it as experimental or not.

[jklymak]

There was talk of adding the ordinal locations to inset_axes. However I'm 99% certain that can be done in a backwards compatible way should someone want to do that.

[timhoffm]

There was talk of adding the ordinal locations to inset_axes. However I'm 99% certain that can be done in a backwards compatible way should someone want to do that.

Yes it could. But I tend to not do it. You either don't have control over the size and margins of the inset, or the API get's really complex. I think keeping it to the an analogous API as Figure.add_axes() is good enough.

[github-actions]

Good first issue - notes for new contributors

This issue is suited to new contributors because it does not require understanding of the Matplotlib internals. To get started, please see our contributing guide.

We do not assign issues. Check the Development section in the sidebar for linked pull requests (PRs). If there are none, feel free to start working on it. If there is an open PR, please collaborate on the work by reviewing it rather than duplicating it in a competing PR.

If something is unclear, please reach out on any of our communication channels.

[rcomer]

I think the work here is:

• Remove the experimental note from the docstring.
• Add a what’s new entry that the method is no longer experimental (it may help to look at the similar entry for subplot_mosaic at DOC: mark mosaic as no longer provisional #24891).

[ShivamPathak99]

Working on it.

[story645]

@ShivamPathak99 you accidentally opened your pull request against @tacaswell 's fork of Matplotlib, so we can't merge it into main. Can you instead open your pull request against https://github.com/matplotlib/matplotlib?

https://matplotlib.org/devdocs/devel/contribute.html#open-a-pull-request-on-matplotlib

My guess is you may have forked Tom's fork instead of forking against matplotlib/matplotlib