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