8000 Mention origin and extent tutorial in API docs for origin kwarg by ngoldbaum · Pull Request #14464 · matplotlib/matplotlib · GitHub
[go: up one dir, main page]

Skip to content

Mention origin and extent tutorial in API docs for origin kwarg #14464

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
Jun 7, 2019

Conversation

ngoldbaum
Copy link
Contributor

PR Summary

This adds a link to the origin and extent tutorial. There's already a link for the extent kwarg below this but I don't think it hurts to have two links since at least for myself I tend to go tunnel vision in these API docs pages and ignore kwargs I don't think I need to care about.

PR Checklist

  • Documentation is sphinx and numpydoc compliant

@jklymak
Copy link
Member
jklymak commented Jun 6, 2019

Looks good but one of your lines is too long.

@ngoldbaum ngoldbaum force-pushed the imshow-origin-doc branch from c30816c to fc1eed9 Compare June 6, 2019 14:56
@ngoldbaum
Copy link
Contributor Author

Oops, fixed.

@@ -5519,6 +5519,9 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
Note that the vertical axes points upward for 'lower'
but downward for 'upper'.

See the example :doc:`/tutorials/intermediate/imshow_extent` for
examples and a more detailed description.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
ex 8000 amples and a more detailed description.
a more detailed description.

I would keep this exactly the same as in the sentence in the extentparameter description. Twice using example is kind of redundant. 😄

https://21987-1385122-gh.circle-artifacts.com/0/home/circleci/project/doc/build/html/api/_as_gen/matplotlib.axes.Axes.imshow.html#matplotlib.axes.Axes.imshow

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I'll keep them consistent but I think the current spelling is actually a little confusing.

Also reword existing note for extent keyword to harmonize and make clearer
@ngoldbaum ngoldbaum force-pushed the imshow-origin-doc branch from fc1eed9 to 2ac762a Compare June 6, 2019 21:13
Copy link
Member
@dstansby dstansby left a comment

Choose a reason for hiding this comment

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

Thanks!

@dstansby dstansby added this to the v3.1.1 milestone Jun 7, 2019
@dstansby dstansby merged commit 59d2df7 into matplotlib:master Jun 7, 2019
meeseeksmachine pushed a commit to meeseeksmachine/matplotlib that referenced this pull request Jun 7, 2019
dstansby added a commit that referenced this pull request Jun 7, 2019
…464-on-v3.1.x

Backport PR #14464 on branch v3.1.x (Mention origin and extent tutorial in API docs for origin kwarg)
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
0