rgommers · Oct 31, 2026 · Oct 29, 2026
diff --git a/requirements.txt b/requirements.txt
@@ -6,3 +6,4 @@ sphinx-copybutton==0.5.2
 sphinx-toolbox==4.3.1
 sphinx-jsonschema==1.20.1
 sphinx-notfound-page==1.1.0
+sphinx-reredirects==1.1.0
diff --git a/source/conf.py b/source/conf.py
@@ -39,6 +39,7 @@
     "sphinx_toolbox.collapse",
     "sphinx-jsonschema",
     "notfound.extension",
+    "sphinx_reredirects",
 ]
 
 nitpicky = True
@@ -272,5 +273,25 @@ def fix_notfound_links(app, doctree, docname):
         replace_uris(app, doctree, nodes.reference, "refuri")
 
 
+# -- Options for sphinx-reredirects ----------------------------------------------------
+# https://documatt.com/sphinx-reredirects/usage/
+
+redirects = {
+    "guides/using-manifest-in": "https://setuptools.pypa.io/en/latest/userguide/miscellaneous.html",
+    "tutorials/creating-documentation": "https://www.sphinx-doc.org/en/master/tutorial/",
+}
+
+# Internal redirects, made relative for the current builder (html or dirhtml)
+internal_redirects = {
+    "guides/single-sourcing-package-version": "discussions/single-source-version",
+}
+
+
+def add_internal_redirects(app):
+    for source, target in internal_redirects.items():
+        app.config.redirects[source] = app.builder.get_relative_uri(source, target)
+
+
 def setup(app):
+    app.connect("builder-inited", add_internal_redirects)
     app.connect("doctree-resolved", fix_notfound_links)
diff --git a/source/guides/appveyor-sample/appveyor.yml b/source/guides/appveyor-sample/appveyor.yml
diff --git a/source/guides/appveyor-sample/build.cmd b/source/guides/appveyor-sample/build.cmd
diff --git a/source/guides/migrating-to-pypi-org.rst b/source/guides/migrating-to-pypi-org.rst
diff --git a/source/guides/multi-version-installs.rst b/source/guides/multi-version-installs.rst
diff --git a/source/guides/single-sourcing-package-version.rst b/source/guides/single-sourcing-package-version.rst