# PEP 732: The Python Documentation Editorial Board **URL:** \ **Category:** PEPs\ **Tags:** governance, documentation, pep\ **Created:** [October 20, 2023, 1:13pm UTC](https://discuss.python.org/t/pep-732-the-python-documentation-editorial-board/36710 "2023-10-20T13:13:46Z")\ **Posts on this page:** 9\ **Page:** 1
**Author:** ![jojablonski](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/jojablonski/32/3159_2.png) [@jojablonski](https://discuss.python.org/u/jojablonski)\ **Post date:** [October 20, 2023, 1:13pm UTC](https://discuss.python.org/t/pep-732-the-python-documentation-editorial-board/36710/1 "2023-10-20T13:13:46Z")
Here’s a new PEP that proposes how the Python Documentation Editorial Board will work: > **[PEP 732 – The Python Documentation Editorial Board | peps.python.org](https://peps.python.org/pep-0732/)** > > Python Enhancement Proposals (PEPs) Any feedback on this PEP would be appreciated. ---
**Author:** ![jacgoldsm](https://avatars.discourse-cdn.com/v4/letter/j/a183cd/32.png) [@jacgoldsm](https://discuss.python.org/u/jacgoldsm)\ **Post date:** [October 20, 2023, 3:41pm UTC](https://discuss.python.org/t/pep-732-the-python-documentation-editorial-board/36710/2 "2023-10-20T15:41:28Z")
Is [docs.python.org](http://docs.python.org) _cpython_ documentation or _python_ documentation? I’ve always thought of it as the latter, though cpython has pride of place as the reference implementation. ---
**Author:** ![nedbat](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/nedbat/32/8744_2.png) [@nedbat](https://discuss.python.org/u/nedbat)\ **Post date:** [October 20, 2023, 3:56pm UTC](https://discuss.python.org/t/pep-732-the-python-documentation-editorial-board/36710/3 "2023-10-20T15:56:45Z")
> Is [docs.python.org](http://docs.python.org) _cpython_ documentation or _python_ documentation? This is a great question. In truth, it’s both. Implementation details (CPython-specific) are called out, but perhaps not as uniformly as they could be. Are there particular issues you’re seeing with that tension? ---
**Author:** ![tjreedy](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/tjreedy/32/137_2.png) [@tjreedy](https://discuss.python.org/u/tjreedy)\ **Post date:** [October 21, 2023, 4:35am UTC](https://discuss.python.org/t/pep-732-the-python-documentation-editorial-board/36710/4 "2023-10-21T04:35:23Z")
The Python 3.x Reference is intended to define the Python 3.x language. Anything specific to CPython, such as ‘object ID = address’, should be noted as such. The PyPY implementation, in particular, forced some clarifications on what was ‘Python’ and what was specifically CPython. Any other implementation should describes _its_ specializations and deviations. The Library Manual describes what come with CPython. Other implementations are at least encouraged to include everything not CPython specific. The C-API is obviously C specific. ---
**Author:** ![hugovk](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/hugovk/32/14505_2.png) [@hugovk](https://discuss.python.org/u/hugovk)\ **Post date:** [October 21, 2023, 5:55am UTC](https://discuss.python.org/t/pep-732-the-python-documentation-editorial-board/36710/5 "2023-10-21T05:55:13Z")
Thank you for working on this! I’m +1 for both the PEP and the initial list of members. The motivation section introduces the Working Group but not the Editorial Board. Could we have a single sentence explaining the relationship between the WG and the EB? For example, this is the EB of the WG. This is partially explained by the diagram. For accessibility, it would help to add such a sentence in the body text, and/or something as alt text. ---
**Author:** ![willingc](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/willingc/32/20_2.png) [@willingc](https://discuss.python.org/u/willingc)\ **Post date:** [October 22, 2023, 2:10pm UTC](https://discuss.python.org/t/pep-732-the-python-documentation-editorial-board/36710/6 "2023-10-22T14:10:26Z")
Great question @jacgoldsm. The Scope section of the PEP clarifies that [docs.python.org](http://docs.python.org) is covered by this PEP. 😄 ---
**Author:** ![jojablonski](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/jojablonski/32/3159_2.png) [@jojablonski](https://discuss.python.org/u/jojablonski)\ **Post date:** [October 23, 2023, 2:16pm UTC](https://discuss.python.org/t/pep-732-the-python-documentation-editorial-board/36710/7 "2023-10-23T14:16:56Z")
@hugovk Thanks for highlighting that we have a terminology issue. It’s bound to happen since two distinct groups have had similar names. When the Steering Council officially sanctioned a group to set direction for the docs, it used the term “working group.” Later, another documentation working group was set up, but it was focused on more tactical work. The original working group for documentation is now called the Editorial Board. We now have two groups: 1. The Documentation Working Group is a community of volunteers contributing to the documentation. 2. The Editorial Board is a more formal group of decision makers. Does that clear it up? ---
**Author:** ![hugovk](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/hugovk/32/14505_2.png) [@hugovk](https://discuss.python.org/u/hugovk)\ **Post date:** [October 23, 2023, 2:58pm UTC](https://discuss.python.org/t/pep-732-the-python-documentation-editorial-board/36710/8 "2023-10-23T14:58:56Z")
Thank you! Yes, now I get it: - Old WG → new EB - Old Docs Community → new WG We had been calling group 1 the “Documentation Community Team” in our monthly meetings, for the community of volunteers: - [Documentation Community Team - Documentation Community documentation](https://docs-community.readthedocs.io/en/latest/community/index.html) - [Monthly Reports Archive - Documentation Community documentation](https://docs-community.readthedocs.io/en/latest/monthly-meeting/index.html) And group 2 was called the “CPython Documentation Workgroup” for the initial formal group of decision makers: - [CPython Documentation Workgroup - Documentation Community documentation](https://docs-community.readthedocs.io/en/latest/workgroup/workgroup_charter.html) I think two things might help: - For continuity, we keep the name of “Documentation Community Team” (or similar) for the community of volunteers contributing to the documentation (group 1). Avoiding “working group” for this looser group would avoid confusion with the original working group, which had a charter and membership votes and so on. Similarly with [PSF Work Groups](https://www.python.org/psf/workgroups/). Anyone can join in group 1: just turn up and get stuck in. - Update the info at [CPython Documentation Workgroup - Documentation Community documentation](https://docs-community.readthedocs.io/en/latest/workgroup/workgroup_charter.html) to say the old WG is now the EB (could be mostly deleted and point to this PEP instead). Can of course wait until the PEP is accepted. ---
**Author:** ![thomas](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/thomas/32/5492_2.png) [@thomas](https://discuss.python.org/u/thomas)\ **Post date:** [December 11, 2023, 2:39pm UTC](https://discuss.python.org/t/pep-732-the-python-documentation-editorial-board/36710/9 "2023-12-11T14:39:19Z")
The SC has decided to accept PEP 732 (The Python Documentation Editorial Board). Our only comment is that while we don’t disagree with the scoping set out in the PEP, it would probably make sense for the EB to consider expanding the scope to include docstrings (in the standard library) once the Board is sufficiently established and the higher priorities have been taken care of. That can be discussed between the EB and SC when the time comes, however.