[Doc]: annotation_clip=None not correctly documented

[trichter]

Documentation Link

https://matplotlib.org/devdocs/api/_as_gen/matplotlib.axes.Axes.annotate.html?highlight=annotate#matplotlib.axes.Axes.annotate

Problem

The documentation of Axes.annotate resp. mpl.text.Annotate states about annotation_clip parameter:

https://github.com/matplotlib/matplotlib/blob/main/lib/matplotlib/text.py#L1776

        annotation_clip : bool or None, default: None
            Whether to draw the annotation when the annotation point *xy* is
            outside the axes area.
            - If *True*, the annotation will only be drawn when *xy* is
              within the axes.
            - If *False*, the annotation will always be drawn.
            - If *None*, the annotation will only be drawn when *xy* is
              within the axes and *xycoords* is 'data'.

Suggested improvement

I think the behavior is different for the default annotation_clip=None.

It should be

• If None, the annotation will only be drawn when xy is
  within the axes and or xycoords is not 'data'.

Because this sounds a bit complicated, I'd suggest

        annotation_clip : bool or None, default: None
            Whether to clip (i.e. not draw) the annotation when the annotation point *xy* is
            outside the axes area.
            - If *True*, the annotation will be clipped when *xy* is outside the axes.
            - If *False*, the annotation will always be drawn.
            - If *None*, the annotation will be clipped when *xy* is outside the axes and *xycoords* is 'data'.

[soma2000-lang]

@trichter I am working on this

[tacaswell]

As a project we do not have any mechanism of claiming an issues short of opening a PR against it.

@soma2000-lang You have said you are working on a number of issues, but I do not see any open PRs from you. Am I missing them?

[QuLogic]

Fixed by #22580.