From 4668bb1ee68aa0ff7ec1d8802cedc0986e243e37 Mon Sep 17 00:00:00 2001
From: Ned Batchelder <ned@nedbatchelder.com>
Date: Sun, 22 Feb 2026 18:46:41 -0500
Subject: [PATCH 1/2] WIP: Docs: use a Sphinx extension to eliminate excessive
 links

---
 Doc/conf.py          | 1 +
 Doc/requirements.txt | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/Doc/conf.py b/Doc/conf.py
index d7effe2572ec44..2721e376298bc1 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -39,6 +39,7 @@
     'sphinx.ext.coverage',
     'sphinx.ext.doctest',
     'sphinx.ext.extlinks',
+    'linklint.ext',
 ]
 
 # Skip if downstream redistributors haven't installed them
diff --git a/Doc/requirements.txt b/Doc/requirements.txt
index d0107744ecbe85..f8f3922ef5be18 100644
--- a/Doc/requirements.txt
+++ b/Doc/requirements.txt
@@ -18,4 +18,6 @@ sphinx-notfound-page~=1.0.0
 # to install that as well.
 python-docs-theme>=2023.3.1,!=2023.7
 
+git+https://github.com/nedbat/linklint
+
 -c constraints.txt

From 2d9353171f0028b9f6cc67d66f2ed8aa05483fd6 Mon Sep 17 00:00:00 2001
From: Ned Batchelder <ned@nedbatchelder.com>
Date: Tue, 24 Feb 2026 07:44:22 -0500
Subject: [PATCH 2/2] move linklint extension to optional

---
 Doc/conf.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Doc/conf.py b/Doc/conf.py
index 2721e376298bc1..351af466213536 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -39,13 +39,13 @@
     'sphinx.ext.coverage',
     'sphinx.ext.doctest',
     'sphinx.ext.extlinks',
-    'linklint.ext',
 ]
 
 # Skip if downstream redistributors haven't installed them
 _OPTIONAL_EXTENSIONS = (
     'notfound.extension',
     'sphinxext.opengraph',
+    'linklint.ext',
 )
 for optional_ext in _OPTIONAL_EXTENSIONS:
     try: