https://python.github.io/editorial-board/ Recent content on Python Docs Editorial Board Hugo -- 0.128.0 en Python Docs Editorial Board and Contributors Tue, 14 Oct 2025 08:11:13 -0700 https://python.github.io/editorial-board/updates/2025-10-14/ Tue, 14 Oct 2025 08:11:13 -0700 https://python.github.io/editorial-board/updates/2025-10-14/ Meeting Minutes from Python Docs Editorial Board: Oct 14, 2025 https://python.github.io/editorial-board/updates/2025-09-09/ Tue, 09 Sep 2025 17:49:01 -0500 https://python.github.io/editorial-board/updates/2025-09-09/ Meeting Minutes from Python Docs Editorial Board: Sep 9, 2025 https://python.github.io/editorial-board/updates/2025-06-10-editorial-board-update/ Tue, 10 Jun 2025 00:00:00 +0000 https://python.github.io/editorial-board/updates/2025-06-10-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: June 10, 2025 https://python.github.io/editorial-board/updates/2025-04-08-editorial-board-update/ Tue, 08 Apr 2025 14:49:46 -0700 https://python.github.io/editorial-board/updates/2025-04-08-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: Apr 8, 2025 https://python.github.io/editorial-board/updates/2025-03-11-editorial-board-update/ Tue, 11 Mar 2025 14:11:49 -0700 https://python.github.io/editorial-board/updates/2025-03-11-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: Mar 11, 2025 https://python.github.io/editorial-board/changelog/2025-03-11-pipes-or-in-sphinx-type-descriptions/ Tue, 11 Mar 2025 00:00:00 +0000 https://python.github.io/editorial-board/changelog/2025-03-11-pipes-or-in-sphinx-type-descriptions/ Additional recommendations in the Style Guide https://github.com/python/devguide/pull/1377/ Summary Discourse topic: How should we mark up multiple types in a type field? Currently, the Python docs use | (pipe) character, similar to how you’d annotate a union of types: :param p: A parameter that takes an int or a float argument. :type p: int | float However, the Sphinx docs says to use the word or: :param p: A parameter that takes an int or a float argument. https://python.github.io/editorial-board/changelog/2024-11-11-dead-batteries-docs/ Tue, 11 Mar 2025 00:00:00 +0000 https://python.github.io/editorial-board/changelog/2024-11-11-dead-batteries-docs/ History of dead batteries: https://discuss.python.org/t/history-of-dead-batteries/68934 Documenting Dead batteries: https://discuss.python.org/t/documenting-dead-batteries/70652 PR: https://github.com/python/cpython/pull/126622 Summary The PR adds a “Removed modules” page that lists modules which have been removed. Each module gets a page (with the original URL) that explains why the module is gone. https://python.github.io/editorial-board/updates/2025-02-11-editorial-board-update/ Tue, 11 Feb 2025 00:00:00 +0000 https://python.github.io/editorial-board/updates/2025-02-11-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: February 11, 2025 https://python.github.io/editorial-board/updates/2025-01-14-editorial-board-update/ Tue, 14 Jan 2025 00:00:00 +0000 https://python.github.io/editorial-board/updates/2025-01-14-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: January 14, 2025 https://python.github.io/editorial-board/updates/2024-12-10-editorial-board-update/ Tue, 10 Dec 2024 00:00:00 +0000 https://python.github.io/editorial-board/updates/2024-12-10-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: December 10, 2024 https://python.github.io/editorial-board/updates/2024-11-11-editorial-board-update/ Mon, 11 Nov 2024 00:00:00 +0000 https://python.github.io/editorial-board/updates/2024-11-11-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: November 11, 2024 https://python.github.io/editorial-board/changelog/2024-10-14-devguide-reorg/ Mon, 14 Oct 2024 00:00:00 +0000 https://python.github.io/editorial-board/changelog/2024-10-14-devguide-reorg/ Refactoring the devguide into a Contribution Guide https://discuss.python.org/t/refactoring-the-devguide-into-a-contribution-guide/63409 Summary We’ve started a large task to restructure the devguide to be more welcoming to non-code contributions. https://python.github.io/editorial-board/updates/2024-10-14-editorial-board-update/ Mon, 14 Oct 2024 00:00:00 +0000 https://python.github.io/editorial-board/updates/2024-10-14-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: October 14, 2024 https://python.github.io/editorial-board/updates/2024-09-09-editorial-board-update/ Mon, 09 Sep 2024 00:00:00 +0000 https://python.github.io/editorial-board/updates/2024-09-09-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: September 09, 2024. https://python.github.io/editorial-board/changelog/2024-08-28-style-guide-recs/ Wed, 28 Aug 2024 00:00:00 +0000 https://python.github.io/editorial-board/changelog/2024-08-28-style-guide-recs/ Additional recommendations in the Style Guide https://github.com/python/devguide/pull/1377/ Summary The Style Guide has been updated with new recommendations about author attribution (don’t include it) and pronunciation of dunder names (“an __init__, not a __init__). https://python.github.io/editorial-board/updates/2024-08-12-editorial-board-update/ Mon, 12 Aug 2024 00:00:00 +0000 https://python.github.io/editorial-board/updates/2024-08-12-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: August 12, 2024. https://python.github.io/editorial-board/changelog/2024-07-18-clarify-timezone/ Thu, 18 Jul 2024 00:00:00 +0000 https://python.github.io/editorial-board/changelog/2024-07-18-clarify-timezone/ Clarify timezone vs “time zone”: https://github.com/python/devguide/pull/1352 Summary The CPython PR #118449 updates the spelling of “timezone” to “time zone”. There was a discussion on the PR that the “timezone” spelling is also acceptable and have been used within the CPython docs consistently. However, both Wikipedia and The Free Dictionary redirect “timezone” to “time zone”. Using the two-word form “time zone” would help separate the concept from the “timezone” class in Python. https://python.github.io/editorial-board/changelog/2024-07-12-function-signatures/ Fri, 12 Jul 2024 00:00:00 +0000 https://python.github.io/editorial-board/changelog/2024-07-12-function-signatures/ Function signatures should include slash and star: https://github.com/python/devguide/pull/1344 Summary If a function accepts positional-only or keyword-only arguments, include the slash and the star in the signature as appropriate. .. function:: some_function(pos1, pos2, /, pos_or_kwd, *, kwd1, kwd2): Although the syntax is terse, it is precise about the allowable ways to call the function and is taken from Python itself. The CPython Devguide has been updated to reflect this recommendation. https://python.github.io/editorial-board/updates/2024-06-03-editorial-board-update/ Mon, 03 Jun 2024 00:00:00 +0000 https://python.github.io/editorial-board/updates/2024-06-03-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: June 03, 2024. https://python.github.io/editorial-board/updates/2024-04-08-editorial-board-update/ Mon, 08 Apr 2024 00:00:00 +0000 https://python.github.io/editorial-board/updates/2024-04-08-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: April 08, 2024. https://python.github.io/editorial-board/updates/2024-03-11-editorial-board-update/ Mon, 11 Mar 2024 00:00:00 +0000 https://python.github.io/editorial-board/updates/2024-03-11-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: March 11, 2024. https://python.github.io/editorial-board/updates/2024-02-12-editorial-board-update/ Mon, 12 Feb 2024 00:00:00 +0000 https://python.github.io/editorial-board/updates/2024-02-12-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: February 12, 2024. https://python.github.io/editorial-board/updates/2024-01-08-editorial-board-update/ Mon, 08 Jan 2024 00:00:00 +0000 https://python.github.io/editorial-board/updates/2024-01-08-editorial-board-update/ Meeting Minutes from Python Docs Editorial Board: January 8, 2024.