Status: Draft. This page is a work in progress, started following the June 2026 meeting.
This is the Editorial Board’s list of significant documentation projects we have identified as valuable and actionable. It reflects our proactive stance: rather than only reacting to requests, we identify important work and find people to carry it out.
How this list works
- Every active project has a committed lead. If a project loses its lead, it becomes Blocked until a new lead steps up.
- Each project names its challenges, not just the goal. Describing the hard parts up front helps contributors know what they are taking on.
- We keep the list short and prioritized rather than long and aspirational, so we can give each project real oversight.
Want to help with a project, or propose a new one? Open an issue on this repo or reach out in the Python Docs Discord.
To hear about new projects, subscribe to the projects RSS feed.
Adding a project
Each project has its own page in
content/projects/.
To propose a project, open an issue and, alongside it, a pull request adding the
project’s page. The project is added to the list when the Editorial Board approves it
and the pull request is merged. See Adding a project
for the details.
Projects
No projects match.
| Project | Status | Lead | Sponsor |
|---|---|---|---|
| Improve syntax documentation Reword the syntax chapters of the Python Language Reference to match current Python: an overview and common uses first, then increasingly complex details, ending with the formal grammar. | Active | Petr Viktorin | Needed |