Status: Draft. This page is a work in progress, started following the June 2026 meeting. It describes what we expect of Editorial Board members and how the board chooses to operate. Comments and suggestions are welcome via an issue.
Purpose
The Python Documentation Editorial Board exists to maintain and improve the quality of Python’s documentation, as established in PEP 732. PEP 732 defines our mandate, scope, responsibilities, and membership rules; this page does not restate the PEP but instead records how the board chooses to work within it.
How we work: proactive, not just reactive
The board considered three possible stances for how members spend their time:
- Reactive — be available to make big decisions when asked (act like a “Steering Council for docs”).
- Hands-on — start and personally carry out significant work (closer to a core-team contributor role than a council role).
- Proactive — identify big documentation projects, reach out to find people to do the work, and lead/shepherd those efforts.
We have chosen to focus on stance 3. Rather than waiting for issues to be escalated to us, the board will actively identify significant documentation work, find and support contributors to take it on, and project-manage those efforts to completion.
We remain available for the reactive decision-making in stance 1 — when the community needs the board to make a big-picture or tie-breaking decision about the docs, we are here to do so. In practice, though, this has rarely been needed: most documentation questions resolve without the board having to step in. Because that reactive load is light, our primary focus is the proactive work described above.
What this means in practice:
- We maintain a list of projects that we believe are worth doing.
- A project is listed only if there is a committed lead for it. The list is not a wish list — every entry has someone accountable for moving it forward.
- Each project is described with enough detail to be actionable, including the challenges and risks involved, not just the desired outcome.
- We hold ourselves to project-managing these efforts, not merely naming them.
Member expectations
Members of the Editorial Board are expected to:
- Attend the monthly board meeting (second Tuesday, 1:30pm Pacific) where possible, and stay engaged asynchronously on Discord between meetings.
- Help identify and prioritize documentation projects.
- Lead or actively shepherd at least one project, or support fellow members who are leading projects.
- Engage constructively with the wider documentation community (the Documentation Working Group, translation teams, and contributors).
- Confirm annually whether they wish to continue serving, per PEP 732.
What it means to lead a project
TODO: define the commitment expected of a project lead — e.g. defining scope, breaking the work into contributable pieces, recruiting and supporting contributors, reporting progress to the board, and seeing the work through.
Joining the board
The process for filling a vacancy is defined in PEP 732 under Editorial Board Member Qualifications:
If a vacancy exists on the board for any reason, the Documentation Editorial Board will publicly announce a call for prospective board members. Prospective board members would submit a brief document stating qualifications and their motivation to serve. The sitting members of the Editorial Board will select new board members by a simple majority where quorum is 80% of the current board.
Before opening a call for new members, the board will publish clear expectations (this page) so prospective members understand what they are signing up for.
TODO: link to the application form / call for members once it is open.