Description

AA-Turner

opened on Jul 18, 2024

Issue body actions

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
• gh-121970: Revert "GH-121970: Extract pydoc_topics into a new extension (#129116)" #131245
• GH-121970: Extract pydoc_topics into a new extension #131256
• [3.13] GH-121970: Extract pydoc_topics into a new extension (GH-131256) #131511
• [3.12] GH-121970: Extract pydoc_topics into a new extension (GH-131256) #131512
• GH-121970: Remove Docutils list monkeypatch #142056
• [3.14] GH-121970: Remove Docutils list monkeypatch (GH-142056) #142088
• [3.13] GH-121970: Remove Docutils list monkeypatch (GH-142056) #142089

Activity

1. AA-Turner

   added

   type-featureA feature request or enhancementA feature request or enhancement

   docsDocumentation in the Doc dirDocumentation in the Doc dir

   on Jul 18, 2024
2. AA-Turner

   added 7 commits that reference this issue on Jul 18, 2024

   pythonGH-121970: Use ``SphinxDirective`` instead of ``Directive``

   40b8b03

   pythonGH-121970: Combine custom Pygments lexers into a package

   8a28671

   pythonGH-121970: Combine custom Pygments lexers into a package

   b380c71

   GH-121970: Combine custom Pygments lexers into a package (#121976)

   7431c37

   pythonGH-121970: Rewrite the C-API annotations extension

   fd6de2f

   pythonGH-121970: Modernise patchlevel

   af4cc37

   GH-121970: Use ``SphinxDirective`` instead of ``Directive`` (#121972)

   ac39151
3. miss-islington

   added 2 commits that reference this issue on Jul 19, 2024

   pythonGH-121970: Use ``SphinxDirective`` instead of ``Directive`` (py…

   4070c51

   pythonGH-121970: Use ``SphinxDirective`` instead of ``Directive`` (py…

   c8dc151
4. AA-Turner

   added 3 commits that reference this issue on Jul 19, 2024

   [3.12] GH-121970: Use ``SphinxDirective`` instead of ``Directive`` (G…

   1855784

   [3.13] GH-121970: Use ``SphinxDirective`` instead of ``Directive`` (G…

   711c328

   GH-121970: Improve the glossary preview in HTML search (#121991)

   adf0b94
5. miss-islington

   added a commit that references this issue on Jul 19, 2024

   pythonGH-121970: Improve the glossary preview in HTML search (pythonG…

   3a257d4
6. 109 remaining items
7. hugovk

   added a commit that references this issue on Mar 14, 2025

   gh-121970: Revert "GH-121970: Extract ``pydoc_topics`` into a new ext…

   ca1bedc
8. AA-Turner

   added 2 commits that reference this issue on Mar 14, 2025

   Revert "pythongh-121970: Revert "pythonGH-121970: Extract ``pydoc_top…

   5c8ef1d

   Reapply "pythonGH-121970: Extract ``pydoc_topics`` into a new extensi…

   29fccb6
9. plashchynski

   added a commit that references this issue on Mar 17, 2025

   pythongh-121970: Revert "pythonGH-121970: Extract ``pydoc_topics`` in…

   219fc85
10. AA-Turner

    added 5 commits that reference this issue on Mar 19, 2025

    GH-121970: Extract `pydoc_topics` into a new extension (#131256)

    c1a02f9

    [3.13] pythonGH-121970: Extract `pydoc_topics` into a new extension (p…

    819dec9

    [3.12] pythonGH-121970: Extract `pydoc_topics` into a new extension (p…

    bc68614

    [3.13] GH-121970: Extract `pydoc_topics` into a new extension (GH-131256

    26b04a1

    [3.12] GH-121970: Extract `pydoc_topics` into a new extension (GH-131256

    e1626c3
11. AA-Turner

    added a commit that references this issue on Nov 29, 2025

    GH-121970: Remove Docutils list monkeypatch (#142056)

    3c11738
12. miss-islington

    added 2 commits that reference this issue on Nov 29, 2025

    pythonGH-121970: Remove Docutils list monkeypatch (pythonGH-142056)

    095e565

    pythonGH-121970: Remove Docutils list monkeypatch (pythonGH-142056)

    941f675
13. AA-Turner

    added 2 commits that reference this issue on Nov 29, 2025

    [3.14] GH-121970: Remove Docutils list monkeypatch (GH-142056) (#142088)

    612213c

    [3.13] GH-121970: Remove Docutils list monkeypatch (GH-142056) (#142089)

    342c9e0
14. StanFromIreland

    added a commit that references this issue on Dec 6, 2025

    pythonGH-121970: Remove Docutils list monkeypatch (python#142056)

    aea747e

Issue actions