Skip to content

Rework headers for individual backend docs. #21188

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
Sep 28, 2021

Conversation

anntzer
Copy link
Contributor

@anntzer anntzer commented Sep 27, 2021

Previously, the first header would be used in the ToC/sidebar, resulting
e.g. in a "matplotlib.backends.backend_gtk3agg" entry even though the
page documents both backend_gtk3agg and backend_gtk3cairo. Instead,
merge the titles, and also get rid of the common "matplotlib.backends"
prefix (the individual API doc entries keep the fully qualified name
anyways).

Also fix the qt docs: the canonical version is now at qtagg/qtcairo, not
qt5agg/qt5cairo.

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).

Previously, the first header would be used in the ToC/sidebar, resulting
e.g. in a "matplotlib.backends.backend_gtk3agg" entry even though the
page documents both backend_gtk3agg and backend_gtk3cairo.  Instead,
merge the titles, and also get rid of the common "matplotlib.backends"
prefix (the individual API doc entries keep the fully qualified name
anyways).

Also fix the qt docs: the canonical version is now at qtagg/qtcairo, not
qt5agg/qt5cairo.
@QuLogic QuLogic added this to the v3.5.0 milestone Sep 28, 2021
@QuLogic QuLogic merged commit d97c332 into matplotlib:master Sep 28, 2021
meeseeksmachine pushed a commit to meeseeksmachine/matplotlib that referenced this pull request Sep 28, 2021
QuLogic added a commit that referenced this pull request Sep 28, 2021
…188-on-v3.5.x

Backport PR #21188 on branch v3.5.x (Rework headers for individual backend docs.)
@anntzer anntzer deleted the backenddocheaders branch September 28, 2021 06:25
tacaswell pushed a commit to tacaswell/matplotlib that referenced this pull request Oct 12, 2021
Rework headers for individual backend docs.
tacaswell pushed a commit that referenced this pull request Oct 20, 2021
Rework headers for individual backend docs.
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