-
-
Notifications
You must be signed in to change notification settings - Fork 7.9k
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
Copy-edit various examples. #27268
Conversation
There was a problem hiding this 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.
galleries/examples/color/README.txt
Outdated
@@ -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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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?
There was a problem hiding this comment.
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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This plots a list of the named colors supported by Matplotlib. | |
This plots a list of the supported named colors. |
same?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
ditto re "supported".
This legend guide extends the `~.Axes.legend` docstring - | ||
please read it first before proceeding with this guide. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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
There was a problem hiding this comment.
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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
In Matplotlib, the location of Axes (including subplots) are specified in | |
the location of Axes (including subplots) are specified in |
There was a problem hiding this comment.
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.
There was a problem hiding this 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.
…268-on-v3.8.x Backport PR #27268 on branch v3.8.x (Copy-edit various examples.)
…268-on-v3.8.1-doc Backport PR #27268 on branch v3.8.1-doc (Copy-edit various examples.)
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