Improve and reorganise ``pyspecific``

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-121971
• gh-121972
• gh-121976
• gh-121985
• gh-121991
• gh-121995
• gh-122008
• gh-122009
• gh-122015
• gh-122016
• gh-122018
• gh-122019
• gh-122020
• gh-122021
• gh-122022
• gh-122023
• gh-122024
• gh-122025
• gh-122027
• gh-122060
• gh-122061
• gh-122065
• gh-122167
• gh-122168
• gh-122325
• gh-122434
• gh-122435
• gh-122651
• gh-122653
• gh-122654
• gh-125082
• gh-125237
• gh-125238
• gh-129105
• gh-129109
• gh-129110
• gh-129116
• gh-129306
• gh-129309
• gh-129310
• gh-129311
• gh-129577
• gh-129586
• gh-129587
• gh-130439
• gh-130440
• gh-130441
• gh-130443
• gh-130448
• gh-130465
• gh-130467
• gh-130615
• gh-130651
• gh-130652
• gh-131245
• gh-131256
• gh-131511
• gh-131512
• gh-142056
• gh-142088
• gh-142089

This is a broad tracking issue for improving and reorganising Python's custom Sphinx extensions, without naming a file, test, or specific change. Review the linked PRs to identify work that has already moved elsewhere; there is no standalone definition of done in this issue.