Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Copy-edit various examples. #27268

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 5, 2023
Merged

Copy-edit various examples. #27268

merged 1 commit into from
Nov 5, 2023

Conversation

anntzer
Copy link
Contributor

@anntzer anntzer commented Nov 5, 2023

Mostly removing "in Matplotlib" (where it is clear that it's a Matplotlib example illustrating how to do stuff in Matplotlib), and removing redundant subtitles.

PR summary

PR checklist

@anntzer anntzer added Documentation Documentation: examples files in galleries/examples labels Nov 5, 2023
Copy link
Member

@story645 story645 left a comment

Choose a reason for hiding this comment

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

Mostly nits of the may as well go all in on not saying "in Matplotlib" variety.

@@ -3,6 +3,6 @@
Color
=====

For more in-depth information about the colormaps available in matplotlib
For more in-depth information about the colormaps available in Matplotlib
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
For more in-depth information about the colormaps available in Matplotlib
For more in-depth information about the built in colormaps

if the goal is removing reduncancy?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

If you have to say "builtin" it's not really better than "in Matplotlib", so we may as well be explicit here.

@@ -3,7 +3,7 @@
List of named colors
====================

This plots a list of the named colors supported in matplotlib.
This plots a list of the named colors supported by Matplotlib.
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
This plots a list of the named colors supported by Matplotlib.
This plots a list of the supported named colors.

same?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

ditto re "supported".

Comment on lines 12 to 13
This legend guide extends the `~.Axes.legend` docstring -
please read it first before proceeding with this guide.
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
This legend guide extends the `~.Axes.legend` docstring -
please read it first before proceeding with this guide.
This legend guide extends the `~.Axes.legend` docstring -
please read it before proceeding with this guide.

@@ -62,7 +59,7 @@
line_down, = ax.plot([3, 2, 1], label='Line 1')
ax.legend(handles=[line_up, line_down])

In some cases, it is not possible to set the label of the handle, so it is
Rarely, it is not possible to set the label of the handle, so it is
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
Rarely, it is not possible to set the label of the handle, so it is
Rarely, it is not possible to set the label of the handle, so it is

I think there's a weird double negation going on here and this sentence may be clearer if it were not inverted, something like

While usually the label is set on the handle, in rare instances you may need to pass through a list of labels

Copy link
Contributor Author

Choose a reason for hiding this comment

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

reworded

@@ -21,11 +21,10 @@
Simple Example
==============

In matplotlib, the location of axes (including subplots) are specified in
In Matplotlib, the location of Axes (including subplots) are specified in
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
In Matplotlib, the location of Axes (including subplots) are specified in
the location of Axes (including subplots) are specified in

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Actually the whole sentence is a bit pointless here, removed it and reworded the following one.

Mostly removing "in Matplotlib" (where it is clear that it's a
Matplotlib example illustrating how to do stuff in Matplotlib), and
removing redundant subtitles.
Copy link
Member

@story645 story645 left a comment

Choose a reason for hiding this comment

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

You can self merge or I'll swing back and merge later.

@story645 story645 added this to the v3.8-doc milestone Nov 5, 2023
@anntzer anntzer merged commit 3c56987 into matplotlib:main Nov 5, 2023
@anntzer anntzer deleted the d branch November 5, 2023 21:26
meeseeksmachine pushed a commit to meeseeksmachine/matplotlib that referenced this pull request Nov 5, 2023
meeseeksmachine pushed a commit to meeseeksmachine/matplotlib that referenced this pull request Nov 5, 2023
story645 added a commit that referenced this pull request Nov 5, 2023
…268-on-v3.8.x

Backport PR #27268 on branch v3.8.x (Copy-edit various examples.)
story645 added a commit that referenced this pull request Nov 5, 2023
…268-on-v3.8.1-doc

Backport PR #27268 on branch v3.8.1-doc (Copy-edit various examples.)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation: examples files in galleries/examples Documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants