Skip to content

Remove individual doc entries for some methods Axes inherits from Artist #19025

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.

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 1 commit into from
Nov 27, 2020

Conversation

anntzer
Copy link
Contributor

@anntzer anntzer commented Nov 26, 2020

The methods are directly inherited, so don't need a separate doc entry. (See #14960 for a longer discussion of a similar case.)

PR Summary

PR Checklist

  • Has pytest style unit tests (and pytest passes).
  • Is Flake 8 compliant (run flake8 on changed files to check).
  • New features are documented, with examples if plot related.
  • Documentation is sphinx and numpydoc compliant (the docs should build without error).
  • Conforms to Matplotlib style conventions (install flake8-docstrings and run flake8 --docstring-convention=all).
  • New features have an entry in doc/users/next_whats_new/ (follow instructions in README.rst there).
  • API changes documented in doc/api/next_api_changes/ (follow instructions in README.rst there).

The methods are directly inherited, so don't need a separate doc entry.
Copy link
Member

@timhoffm timhoffm left a comment

Choose a reason for hiding this comment

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

I don't have a clear view how to reasonably handle inherited methods so that they are still reasonably discoverable (IIRC there's a separate discussion somewhere).

For this particular case however, it's reasonable to not list the given methods. get/set_contains is deprecated anyway, and I suppose there's little need for picking an Axes. It's better to remove them to reduce clutter.

@timhoffm timhoffm added this to the v3.4.0 milestone Nov 27, 2020
@timhoffm timhoffm merged commit 0fc0e1d into matplotlib:master Nov 27, 2020
@anntzer anntzer deleted the inherited-axes-methods branch November 28, 2020 11:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants