Fix typos and grammar errors across documentation by him2him2 · Pull Request #144709 · python/cpython

him2him2 · 2026-02-11T14:11:02Z

Fix 77 typos and grammar errors in 39 documentation files.

Categories of fixes:

Spelling errors: "seperately" → "separately", "preveiously" → "previously"
Subject-verb agreement: "functions uses" → "functions use", "protocol require" → "protocol requires", "names takes" → "names take"
Missing words: "if there no" → "if there is no", "must one of" → "must be one of", "are longer called" → "are no longer called"
Extra words: "effects with involving" → "effects involving", "whose the result" → "whose result", "the its behavior" → "its behavior"
Wrong prepositions: "obey to the following" → "obey the following", "equals to" → "equals"
Wrong word forms: "fallback on" → "fall back on", "In the later case" → "In the latter case", "most noticeable" → "most notably"
Grammatical fixes: "allows to run" → "allows you to run", "equivalent to call" → "equivalent to calling"
Duplicated text: "a lock a lock" → "a lock", "next the timer next fires" → "the timer next fires"
Miscellaneous: double space, missing space before parenthesis, American English spelling ("behaviour" → "behavior")

Files changed by section:

Section	Files	Fixes
`Doc/tutorial/`	5	7
`Doc/c-api/`	7	13
`Doc/library/`	22	52
Misc (`glossary`, `bugs`, `copyright`, `license`, `deprecations`)	5	5
Total	39	77

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

Fix 77 issues in 39 documentation files including: - Spelling errors (e.g., "seperately", "preveiously") - Subject-verb agreement (e.g., "functions uses" -> "functions use") - Missing or extra words (e.g., "if there no" -> "if there is no") - Wrong prepositions (e.g., "obey to" -> "obey", "equals to" -> "equals") - Wrong word forms (e.g., "fallback" -> "fall back", "later" -> "latter") - Grammatical fixes (e.g., "allows to run" -> "allows you to run") - Duplicated text (e.g., "a lock a lock" -> "a lock") - Miscellaneous (double space, missing space, American English spelling)

python-cla-bot · 2026-02-11T14:11:08Z

All commit authors signed the Contributor License Agreement.

AlexWaygood

Thanks! Mostly looks good. Some suggestions.

Doc/library/pickle.rst

AlexWaygood · 2026-02-11T14:20:57Z

Doc/library/resource.rst

+   has been used, e.g. amount of time spent running in user mode or number of times
   the process was swapped out of main memory. Some values are dependent on the
-   clock tick internal, e.g. the amount of memory the process is using.
+   clock tick interval, e.g. the amount of memory the process is using.


is this definitely meant to be "interval" rather than "internals"? (If we're not sure, I'd just revert this change for now.)

Good question! The original text was actually clock tick internal (not "internals"), so the choice was between "interval" and "internal". "Clock tick interval" is standard Unix/POSIX terminology — it refers to the duration between system clock ticks. The sentence reads: "Some values are dependent on the clock tick interval, e.g. the amount of memory the process is using." That lines up with how getrusage(2) works, where certain resource measurements are quantized to clock tick boundaries.

Happy to revert if you'd prefer to be cautious though!

OK, that makes sense to me, thanks for checking!

Doc/library/shutil.rst

Doc/library/signal.rst

Doc/library/site.rst

Doc/tutorial/controlflow.rst

Doc/tutorial/inputoutput.rst

Doc/copyright.rst

Doc/glossary.rst

Doc/license.rst

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Doc/library/tracemalloc.rst

Revert copyright.rst, license.rst (legal documents should not be modified), and inputoutput.rst (British spelling "behaviour" is acceptable in CPython docs).

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

him2him2 · 2026-02-11T16:31:59Z

Thanks so much for the thorough review @AlexWaygood! Really appreciate you taking the time to go through all of these — your suggestions were spot on. All changes have been applied.

miss-islington-app · 2026-02-11T16:35:31Z

Thanks @him2him2 for the PR, and @AlexWaygood for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14.
🐍🍒⛏🤖 I'm not a witch! I'm not a witch!

miss-islington-app · 2026-02-11T16:35:34Z

Sorry, @him2him2 and @AlexWaygood, I could not cleanly backport this to 3.14 due to a conflict.
Please backport using cherry_picker on command line.

cherry_picker 3718f4be60ebb0725b35f597a9de3f7a93ba9f72 3.14

miss-islington-app · 2026-02-11T16:35:38Z

Sorry, @him2him2 and @AlexWaygood, I could not cleanly backport this to 3.13 due to a conflict.
Please backport using cherry_picker on command line.

cherry_picker 3718f4be60ebb0725b35f597a9de3f7a93ba9f72 3.13

AlexWaygood · 2026-02-11T16:36:16Z

@him2him2, would you be able to take care of the backports using the instructions the bot gave?

him2him2 requested review from a team, AlexWaygood, FFY00, JelleZijlstra, berkerpeksag, ericsnowcurrently, erlend-aasland, giampaolo and gpshead as code owners February 11, 2026 14:11

bedevere-app bot added the awaiting review label Feb 11, 2026

bedevere-app bot added docs Documentation in the Doc dir skip news labels Feb 11, 2026

github-project-automation bot added this to Docs PRs Feb 11, 2026

github-project-automation bot moved this to Todo in Docs PRs Feb 11, 2026

AlexWaygood reviewed Feb 11, 2026

View reviewed changes

AlexWaygood added the skip issue label Feb 11, 2026

him2him2 and others added 10 commits February 11, 2026 09:49

Update Doc/library/pickle.rst

a48d0ea

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Update Doc/library/shutil.rst

f9f719e

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Update Doc/library/signal.rst

6d86f27

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Update Doc/library/site.rst

060353c

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Update Doc/tutorial/controlflow.rst

bb84df3

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Update Doc/glossary.rst

1ffed59

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Update Doc/library/trace.rst

830d14e

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Update Doc/library/tracemalloc.rst

c380dd0

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Update Doc/library/typing.rst

314fb04

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

Update Doc/tutorial/controlflow.rst

35bc554

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

AlexWaygood reviewed Feb 11, 2026

View reviewed changes

Doc/library/tracemalloc.rst Outdated Show resolved Hide resolved

Revert changes to legal docs and British English spelling

c00f418

Revert copyright.rst, license.rst (legal documents should not be modified), and inputoutput.rst (British spelling "behaviour" is acceptable in CPython docs).

Update Doc/library/tracemalloc.rst

c5b0895

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

giampaolo removed their request for review February 11, 2026 15:15

Merge branch 'main' into fix-doc-typos-and-grammar

8d734bf

AlexWaygood added needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes labels Feb 11, 2026

AlexWaygood merged commit 3718f4b into python:main Feb 11, 2026
33 checks passed

github-project-automation bot moved this from Todo to Done in Docs PRs Feb 11, 2026

bedevere-app bot removed the awaiting review label Feb 11, 2026

miss-islington-app bot assigned AlexWaygood Feb 11, 2026

Uh oh!

Conversation

him2him2 commented Feb 11, 2026 • edited by github-actions bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

python-cla-bot bot commented Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

AlexWaygood left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

AlexWaygood Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

him2him2 Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

AlexWaygood Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

him2him2 commented Feb 11, 2026

Uh oh!

Uh oh!

miss-islington-app bot commented Feb 11, 2026

Uh oh!

miss-islington-app bot commented Feb 11, 2026

Uh oh!

miss-islington-app bot commented Feb 11, 2026

Uh oh!

AlexWaygood commented Feb 11, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

him2him2 commented Feb 11, 2026 •

edited by github-actions bot

Loading

python-cla-bot bot commented Feb 11, 2026 •

edited

Loading

AlexWaygood Feb 11, 2026 •

edited

Loading