Reword the Expressions chapter of the docs
Open
@encukou is already working on this.
Since Nov 26, 2025.
docs
- Dominant language
- Python
- Stars
- 77.2k
- Forks
- 35.9k
- PR merge metrics
- PR metrics pending
Description
Continuing after https://github.com/python/cpython/issues/127833 and #135676, I'd like to reword and restructure the Expressions section of the Reference documentation.
I think I found a style that works: each section will start with the most obvious things, expand toward a complete & precise description, with examples along the way, and end with the formal grammar. (Currently the grammar is usually listed first, and the author of the prose is tempted to assume that the reader has parsed and understood it.)
Linked PRs
- gh-141985
- gh-144117
- gh-144476
- gh-144959
- gh-144964
- gh-148622
- gh-150517
- gh-150518
- gh-150552
- gh-151261
- gh-151267
- gh-154884
- gh-156836
- gh-157225
- gh-157271
- gh-157272
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.