Improve and reorganise pyspecific

[AA-Turner]

Feature or enhancement

Proposal:

Python has several custom Sphinx extensions, many of which use older constructs and can be simplified and improved. This serves as a tracking issue for such PRs.

Has this already been discussed elsewhere?

This is a minor feature, which does not need previous discussion elsewhere

Links to previous discussion of this feature:

No response

Linked PRs

• GH-121970: Make DeprecatedRemoved a subclass of VersionChange #121971
• GH-121970: Use SphinxDirective instead of Directive #121972
• GH-121970: Combine custom Pygments lexers into a package #121976
• GH-121970: Rewrite the C-API annotations extension #121985
• GH-121970: Improve the glossary preview in HTML search #121991
• GH-121970: Modernise the patchlevel extension #121995
• [3.13] GH-121970: Use SphinxDirective instead of Directive (GH-121972) #122008
• [3.12] GH-121970: Use SphinxDirective instead of Directive (GH-121972) #122009
• [3.13] GH-121970: Improve the glossary preview in HTML search (GH-121991) #122015
• [3.12] GH-121970: Improve the glossary preview in HTML search (GH-121991) #122016
• GH-121970: Use Ruff to check and format the docs tools #122018
• [3.13] GH-121970: Make DeprecatedRemoved a subclass of VersionChange (GH-121971) #122019
• [3.12] GH-121970: Make DeprecatedRemoved a subclass of VersionChange (GH-121971) #122020
• [3.13] GH-121970: Combine custom Pygments lexers into a package (GH-121976) #122021
• [3.12] GH-121970: Combine custom Pygments lexers into a package (GH-121976) #122022
• [3.13] GH-121970: Use Ruff to check and format the docs tools (GH-122018) #122023
• [3.12] GH-121970: Use Ruff to check and format the docs tools (GH-122018) #122024
• [3.12] GH-121970: Rewrite the C-API annotations extension (GH-121985) #122025
• [3.13] GH-121970: Rewrite the C-API annotations extension (#121985) #122027
• [3.13] GH-121970: Modernise the patchlevel extension (GH-121995) #122060
• [3.12] GH-121970: Modernise the patchlevel extension (GH-121995) #122061
• GH-121970: Remove escape4chm #122065
• [3.13] GH-121970: Remove escape4chm (GH-122065) #122167
• [3.12] GH-121970: Remove escape4chm (GH-122065) #122168
• GH-121970: Extract audit_events into a new extension #122325
• [3.13] GH-121970: Extract audit_events into a new extension (GH-122325) #122434
• [3.12] GH-121970: Extract audit_events into a new extension (GH-122325) #122435
• GH-121970: Fix gettext for audit events #122651
• [3.13] GH-121970: Fix gettext for audit events (GH-122651) #122653
• [3.12] GH-121970: Fix gettext for audit events (GH-122651) #122654
• GH-121970: Extract availability into a new extension #125082
• [3.13] GH-121970: Extract availability into a new extension (GH-125082) #125237
• [3.12] GH-121970: Extract availability into a new extension (GH-125082) #125238
• GH-121970: Extract changes into a new extension #129105
• [3.13] GH-121970: Extract changes into a new extension (GH-129105) #129109
• [3.12] GH-121970: Extract changes into a new extension (GH-129105) #129110
• GH-121970: Extract pydoc_topics into a new extension #129116
• GH-121970: Remove pyspecific PyDecoratorMixin patches #129306
• [3.13] GH-121970: Remove pyspecific PyDecoratorMixin patches (GH-129306) #129309
• [3.12] GH-121970: Remove pyspecific PyDecoratorMixin patches (GH-129306) #129310
• GH-121970: Replace custom abstract method directive with the :abstract: option #129311
• GH-121970: Extract misc_news into a new extension #129577
• [3.13] GH-121970: Extract misc_news into a new extension (GH-129577) #129586
• [3.12] GH-121970: Extract misc_news into a new extension (GH-129577) #129587
• [3.13] GH-121970: Replace custom abstract method directive with the :abstract: option (#129311) #130439
• [3.12] GH-121970: Replace custom abstract method directive with the :abstract: option (GH-129311) #130440
• [3.13] GH-121970: Extract pydoc_topics into a new extension (#129116) #130441
• [3.12] GH-121970: Extract pydoc_topics into a new extension (#129116) #130443
• gh-121970: Replace .. coroutine{method,function} with :async: #130448
• [3.13] gh-121970: Replace .. coroutine{method,function} with :async: (GH-130448) #130465
• [3.12] gh-121970: Replace .. coroutine{method,function} with :async: (GH-130448) #130467
• GH-121970: Extract issue_role into a new extension #130615
• [3.13] GH-121970: Extract issue_role into a new extension (GH-130615) #130651
• [3.12] GH-121970: Extract issue_role into a new extension (GH-130615) #130652

[sobolevn]

I think that we also can remove coroutinemethod definition and just use :async:

Before:

After:

I will send a PR for that.

[AA-Turner]

I think that we also can remove coroutinemethod definition and just use :async:

We discussed this at the docs meeting, I think I had an action to update something in Sphinx. I will go back and check.

[sobolevn]

We discussed this at the docs meeting

Is it open for everyone? I would like to participate in the future, if possible :)

[AA-Turner]

The first Tuesday of each month, see e.g. https://discuss.python.org/t/documentation-community-meeting-tuesday-4th-february-2025/78750/1