Skip to content

Fix various user-visible typos #136884

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

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

corneliusroemer
Copy link
Contributor

@corneliusroemer corneliusroemer commented Jul 20, 2025

Typos were identified by https://jules.google and manually reviewed for correctness (there were a bunch of false positives).


📚 Documentation preview 📚: https://cpython-previews--136884.org.readthedocs.build/

Typos were identified by google.jules and manually reviewed for correctness
@StanFromIreland
Copy link
Member

You need to run make clinic

@corneliusroemer
Copy link
Contributor Author

@StanFromIreland Thanks! I had already noticed and run ./configure && make regen-all which seems to have fixed it. Now CI is green!

Copy link
Member

@AA-Turner AA-Turner left a comment

Choose a reason for hiding this comment

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

As with your other PR -- mass spelling error PRs are generally unhelpful. This one has already been approved by Peter though, and is much smaller, so happier to keep it.

A

Doc/bugs.rst Outdated
It can be sometimes faster to fix bugs yourself and contribute patches to
Python as it streamlines the process and involves less people. Learn how to
It can sometimes be faster to fix bugs yourself and contribute patches to
Python as it streamlines the process and involves fewer people. Learn how to
Copy link
Member

Choose a reason for hiding this comment

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

This is arguable, please revert

Copy link
Contributor Author

Choose a reason for hiding this comment

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

done, I don't think less is not a grammar error but I'm happy to remove it

Copy link
Member

Choose a reason for hiding this comment

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

@corneliusroemer sorry, I only meant to revert line 12 (less v fewer) -- fixing the split infinitive on L11 is fine to keep.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Sorry, I overcorrected. Could you maybe explain your reasoning behind not changing "less people"?

People often use less with countable nouns There were less cars on the road then. This is not considered correct in standard English, and fewer should be used instead.
-- Oxford Learner's Dictionary: https://www.oxfordlearnersdictionaries.com/definition/english/less_1?q=less:

Copy link
Member

Choose a reason for hiding this comment

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

Because English is silly and everyone understands "less" anyway. More practically, we don't want to inspire copycat PRs that change "less" to "fewer" everywhere.

@bedevere-app
Copy link

bedevere-app bot commented Jul 20, 2025

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

@ZeroIntensity
Copy link
Member

I approved this on the basis that this is changing actual documentation, so typo fixes are actually useful to readers. I refrained from immediately merging for fear that someone would be concerned about the churn, so if anyone is strongly opposed, please speak up.

@corneliusroemer
Copy link
Contributor Author

If you don't want typo fixes in comments, maybe you can make this explicit in the docs? I can't find guidance saying "We don't want fixes to typos in comments". Not being explicitly welcomed doesn't mean unwelcome. And typo fixes aren't formatting.

Pull requests with only code formatting changes are usually rejected. On the other hand, fixes for typos and grammar errors in documents and docstrings are welcome.

Google Chrome 2025-07-21 01 46 05

https://devguide.python.org/getting-started/pull-request-lifecycle/

@AA-Turner
Copy link
Member

It's somewhat of a grey area. Mainly what we don't want is large PRs touching lots of files. We also want to avoid churn. Therefore, some 'comment typo' PRs are accepted, and some are rejected -- there's no bright line to point to, nor a hard and fast rule.

A

@corneliusroemer
Copy link
Contributor Author

Alright, I hope those 2 PRs are acceptable - those are the most docs/docstring-like from the big PR:

Grouped and scoped

@corneliusroemer corneliusroemer changed the title Various typo fixes Fix typos in Doc/bugs.rst iOS/README.rst Modules/_abc.c Misc/rhel7/README.md Mac/BuildScript/README.rst Lib/_py_warnings.py Doc/c-api/init.rst Jul 21, 2025
Copy link
Contributor

@freakboy3742 freakboy3742 left a comment

Choose a reason for hiding this comment

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

FWIW, since I was tagged; the one change to the iOS docs is a substantive and useful change.

@picnixz picnixz changed the title Fix typos in Doc/bugs.rst iOS/README.rst Modules/_abc.c Misc/rhel7/README.md Mac/BuildScript/README.rst Lib/_py_warnings.py Doc/c-api/init.rst Fix various user-visible typos Jul 21, 2025
@picnixz
Copy link
Member

picnixz commented Jul 21, 2025

Sorry for changing your title but this one would be too long for a commit message. I changed the other because there were only two files. Ideally, I prefer having one PR for fixing specific typos in specific places instead of having one PR touching many files but since Peter accepted this one, I won't ask you to split it again.

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.

6 participants