Reword the Lexical Analysis chapter of the docs
Open
@encukou is already working on this.
Since Jun 18, 2025.
docs
- Dominant language
- Python
- Stars
- 77.2k
- Forks
- 35.9k
- PR merge metrics
- PR metrics pending
Description
Documentation
Continuing with #127833, I'd like to reword and restructure the Lexical analysis 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.)
PRs merged for this before opening this issue:
- #131468
- #131474
- #132407
Linked PRs
- gh-134850
- gh-135677
- gh-135942
- gh-137048
- gh-137469
- gh-137713
- gh-138194
- gh-138457
- gh-139781
- gh-140464
- gh-142015
- gh-142227
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.