From 621eba9e7b819978e248110e370bd533a9cfe3e2 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 27 Jul 2024 14:27:16 +0300
Subject: [PATCH 1/2] Create dedicated page for deprecations

---
 Doc/contents.rst                      |  1 +
 Doc/deprecations/index.rst            | 10 ++++++++++
 Doc/tools/templates/indexcontent.html |  2 ++
 3 files changed, 13 insertions(+)
 create mode 100644 Doc/deprecations/index.rst

diff --git a/Doc/contents.rst b/Doc/contents.rst
index 24ceacb0076b5e..b57f4b09a5dcb6 100644
--- a/Doc/contents.rst
+++ b/Doc/contents.rst
@@ -14,6 +14,7 @@
    installing/index.rst
    howto/index.rst
    faq/index.rst
+   deprecations/index.rst
    glossary.rst
 
    about.rst
diff --git a/Doc/deprecations/index.rst b/Doc/deprecations/index.rst
new file mode 100644
index 00000000000000..5b2af0173b0dd3
--- /dev/null
+++ b/Doc/deprecations/index.rst
@@ -0,0 +1,10 @@
+Deprecations
+============
+
+.. include:: ../deprecations/pending-removal-in-3.14.rst
+
+.. include:: ../deprecations/pending-removal-in-3.15.rst
+
+.. include:: ../deprecations/pending-removal-in-3.16.rst
+
+.. include:: ../deprecations/pending-removal-in-future.rst
diff --git a/Doc/tools/templates/indexcontent.html b/Doc/tools/templates/indexcontent.html
index 6f854e86ab8ef1..f2e9fbb0106452 100644
--- a/Doc/tools/templates/indexcontent.html
+++ b/Doc/tools/templates/indexcontent.html
@@ -33,6 +33,8 @@ <h1>{{ docstitle|e }}</h1>
          <span class="linkdescr">{% trans %}C API reference{% endtrans %}</span></p>
       <p class="biglink"><a class="biglink" href="{{ pathto("faq/index") }}">{% trans %}FAQs{% endtrans %}</a><br/>
          <span class="linkdescr">{% trans %}Frequently asked questions (with answers!){% endtrans %}</span></p>
+      <p class="biglink"><a class="biglink" href="{{ pathto("deprecations/index") }}">{% trans %}Deprecations{% endtrans %}</a><br/>
+         <span class="linkdescr">{% trans %}Deprecated functionality{% endtrans %}</span></p>
     </td></tr>
   </table>
 

From 330172ff62f4943ae28a7e22adb14e08c946e12c Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 27 Jul 2024 23:59:02 +0300
Subject: [PATCH 2/2] Better paths

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
---
 Doc/deprecations/index.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Doc/deprecations/index.rst b/Doc/deprecations/index.rst
index 5b2af0173b0dd3..cfb30dd09aef6f 100644
--- a/Doc/deprecations/index.rst
+++ b/Doc/deprecations/index.rst
@@ -1,10 +1,10 @@
 Deprecations
 ============
 
-.. include:: ../deprecations/pending-removal-in-3.14.rst
+.. include:: pending-removal-in-3.14.rst
 
-.. include:: ../deprecations/pending-removal-in-3.15.rst
+.. include:: pending-removal-in-3.15.rst
 
-.. include:: ../deprecations/pending-removal-in-3.16.rst
+.. include:: pending-removal-in-3.16.rst
 
-.. include:: ../deprecations/pending-removal-in-future.rst
+.. include:: pending-removal-in-future.rst