From ea66507c76b4469b15dd59b9398e926e47bcd9b8 Mon Sep 17 00:00:00 2001
From: rootiest <chris@rootiest.com>
Date: Mon, 27 Jul 2026 01:08:24 -0400
Subject: [PATCH] docs(site): rename Overview sidebar labels to fix pagination

Renamed the root 'Overview' entry under 'Functions Reference' to 'Categories'. Also renamed the inner category 'Overview' entries to '{Category} Overview'. Because Starlight uses the sidebar label for the 'Next/Previous' pagination buttons at the bottom of pages, having multiple pages labeled just 'Overview' caused the button text to ambiguously say 'Next: Overview' even when linking to a new category.
---
 docs/build-manual.py  | 4 ++--
 docs/verify-manual.py | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/build-manual.py b/docs/build-manual.py
index 66e2c8a..c876671 100644
--- a/docs/build-manual.py
+++ b/docs/build-manual.py
@@ -698,7 +698,7 @@ def build_site(root: Path, out: Path) -> list[dict]:
             functions_group = {
                 "label": fm["title"],
                 "collapsed": True,
-                "items": [{"label": "Overview", "link": f"/{slug_dir}/"}],
+                "items": [{"label": "Categories", "link": f"/{slug_dir}/"}],
             }
             sidebar.append(functions_group)
             continue
@@ -756,7 +756,7 @@ def build_site(root: Path, out: Path) -> list[dict]:
                 "label": fm["title"],
                 "collapsed": True,
                 "items": [
-                    {"label": "Overview", "link": f"/{slug_dir}/{category}/"},
+                    {"label": f"{fm['title']} Overview", "link": f"/{slug_dir}/{category}/"},
                     *links,
                 ],
             }
diff --git a/docs/verify-manual.py b/docs/verify-manual.py
index 47409dc..6e50823 100644
--- a/docs/verify-manual.py
+++ b/docs/verify-manual.py
@@ -760,7 +760,7 @@ def test_sidebar_has_no_duplicate_functions_entry():
     assert group["label"] not in labels[1:], (
         f"'{group['label']}' is repeated inside its own group: {labels}"
     )
-    assert labels[0] == "Overview", f"group should lead with Overview, got {labels[0]}"
+    assert labels[0] == "Categories", f"group should lead with Categories, got {labels[0]}"
     assert not any(
         "autogenerate" in item for item in group["items"]
     ), "categories should be listed explicitly, not autogenerated from slugs"