From 9edfdba8dc12d898dc14fe345fde18109f8c3c9f Mon Sep 17 00:00:00 2001
From: A5rocks <git@helvetica.moe>
Date: Thu, 15 Jan 2026 00:47:28 -0500
Subject: [PATCH 1/4] Try adding `genindex.html` to toc

---
 docs/source/index.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/source/index.rst b/docs/source/index.rst
index f8fc6add8..d64d28041 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -86,6 +86,7 @@ Vital statistics:
    contributing.rst
    releasing.rst
    code-of-conduct.rst
+   genindex
 
 ====================
  Indices and tables

From 9594f73579c039bb1f28773a8b9c72d175387d51 Mon Sep 17 00:00:00 2001
From: A5rocks <git@helvetica.moe>
Date: Thu, 15 Jan 2026 14:56:51 +0900
Subject: [PATCH 2/4] Try making a new genindex template

---
 docs/source/_templates/genindex.html | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 docs/source/_templates/genindex.html

diff --git a/docs/source/_templates/genindex.html b/docs/source/_templates/genindex.html
new file mode 100644
index 000000000..51ee51aff
--- /dev/null
+++ b/docs/source/_templates/genindex.html
@@ -0,0 +1,5 @@
+{% extends "!genindex.html" %}
+
+{% block body %}
+<p>TESTING</p>
+{% endblock %}

From cb6a6d8b5e770a8fc4239b9591abde9e2cf8649f Mon Sep 17 00:00:00 2001
From: A5rocks <git@helvetica.moe>
Date: Thu, 15 Jan 2026 15:03:15 +0900
Subject: [PATCH 3/4] Completely copy over the basic template genindex

---
 docs/source/_templates/genindex.html | 33 +++++++++++++++++++++++++++-
 1 file changed, 32 insertions(+), 1 deletion(-)

diff --git a/docs/source/_templates/genindex.html b/docs/source/_templates/genindex.html
index 51ee51aff..cec1a4f13 100644
--- a/docs/source/_templates/genindex.html
+++ b/docs/source/_templates/genindex.html
@@ -1,5 +1,36 @@
 {% extends "!genindex.html" %}
 
+{# check sphinx/themes/basic/genindex:sidebartitle if this snippet has become outdated #}
+
 {% block body %}
-<p>TESTING</p>
+
+<h1 id="index">{{ _('Index') }}</h1>
+
+<div class="genindex-jumpbox">
+ {% for key, dummy in genindexentries -%}
+ <a href="#{{ key }}"><strong>{{ key }}</strong></a>
+ {% if not loop.last %}| {% endif %}
+ {%- endfor %}
+</div>
+
+{%- for key, entries in genindexentries %}
+<h2 id="{{ key }}">{{ key }}</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  {%- for column in entries|slice_index(2) if column %}
+  <td style="width: 33%; vertical-align: top;"><ul>
+    {%- for entryname, (links, subitems, _) in column %}
+      <li>{{ indexentries(entryname, links) }}
+      {%- if subitems %}
+      <ul>
+      {%- for subentryname, subentrylinks in subitems %}
+        <li>{{ indexentries(subentryname, subentrylinks) }}</li>
+      {%- endfor %}
+      </ul>
+      {%- endif -%}</li>
+    {%- endfor %}
+  </ul></td>
+  {%- endfor %}
+</tr></table>
+{% endfor %}
+
 {% endblock %}

From ba8aa63118238259ab1bdda26051e535bb8b0eb0 Mon Sep 17 00:00:00 2001
From: A5rocks <git@helvetica.moe>
Date: Thu, 15 Jan 2026 15:20:34 +0900
Subject: [PATCH 4/4] Hacks to make index fully qualified

---
 docs/source/_templates/genindex.html | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/source/_templates/genindex.html b/docs/source/_templates/genindex.html
index cec1a4f13..ddc30001c 100644
--- a/docs/source/_templates/genindex.html
+++ b/docs/source/_templates/genindex.html
@@ -19,11 +19,13 @@ <h2 id="{{ key }}">{{ key }}</h2>
   {%- for column in entries|slice_index(2) if column %}
   <td style="width: 33%; vertical-align: top;"><ul>
     {%- for entryname, (links, subitems, _) in column %}
-      <li>{{ indexentries(entryname, links) }}
+      {% set name = links[0][1].rsplit('#', 1)[1] if links else '' %}
+      <li>{{ indexentries(name if name and '-' not in name else entryname, links) }}
       {%- if subitems %}
       <ul>
       {%- for subentryname, subentrylinks in subitems %}
-        <li>{{ indexentries(subentryname, subentrylinks) }}</li>
+        {% set sname = subentrylinks[0][1].rsplit('#', 1)[1] if subentrylinks else '' %}
+        <li>{{ indexentries(sname if sname and '-' not in sname else subentryname, subentrylinks) }}</li>
       {%- endfor %}
       </ul>
       {%- endif -%}</li>