Skip to content

[DOC]: make spanselector example codeblock continuous #24037

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 2 commits into from
Sep 29, 2022

Conversation

ianhi
Copy link
Contributor

@ianhi ianhi commented Sep 28, 2022

PR Summary

The spanselector example currently has the code broken up into two chunks by a plot. This is confusing because it's easy to copy the first block without the second and then get confused why it doesn't work (like just happened to me). I think that this will make the codeblock continuous so it's easier to copy and not get confused.

PR Checklist

Tests and Styling

  • [NA] Has pytest style unit tests (and pytest passes).
  • [NA] Is Flake 8 compliant (install flake8-docstrings and run flake8 --docstring-convention=all).

Documentation

  • [NA] New features are documented, with examples if plot related.
  • [NA] New features have an entry in doc/users/next_whats_new/ (follow instructions in README.rst there).
  • [NA] API changes documented in doc/api/next_api_changes/ (follow instructions in README.rst there).
  • [?] Documentation is sphinx and numpydoc compliant (the docs should build without error).

@ianhi ianhi changed the title [DOC]: make spanselector codeblock continuous [DOC]: make spanselector example codeblock continuous Sep 28, 2022
@story645 story645 added this to the v3.6-doc milestone Sep 28, 2022
@QuLogic
Copy link
Member

QuLogic commented Sep 28, 2022

Since it's at the top now, it's better to move it into the docstring instead of as a separate comment.

@story645
Copy link
Member

I like it as the note cause I figure then it's more likely to get read.

@timhoffm
Copy link
Member

The note can still be part of the docstring.

@story645 story645 modified the milestones: v3.6-doc, v3.6.1, v3.6.2 Sep 29, 2022
@timhoffm timhoffm merged commit 7a25f50 into matplotlib:main Sep 29, 2022
meeseeksmachine pushed a commit to meeseeksmachine/matplotlib that referenced this pull request Sep 29, 2022
@ianhi ianhi deleted the span-example branch September 29, 2022 16:49
timhoffm added a commit that referenced this pull request Sep 29, 2022
…037-on-v3.6.x

Backport PR #24037 on branch v3.6.x ([DOC]: make spanselector example codeblock continuous)
@ksunden ksunden mentioned this pull request Feb 20, 2023
6 tasks
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.

4 participants