diff --git a/.github/workflows/deploy-gh-pages.yml b/.github/workflows/deploy-gh-pages.yml
index faa554a..7ead0e8 100644
--- a/.github/workflows/deploy-gh-pages.yml
+++ b/.github/workflows/deploy-gh-pages.yml
@@ -29,6 +29,10 @@ jobs:
       cancel-in-progress: false
     permissions:
       contents: write
+    env:
+      # See docs.yml: silences the properdocs notice pulled in by the nav and
+      # page generation plugins.
+      DISABLE_MKDOCS_2_WARNING: "true"
 
     steps:
       - uses: actions/checkout@v7
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index e35cbf3..34b0dd5 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -10,6 +10,11 @@ permissions:
 jobs:
   docs:
     runs-on: ubuntu-latest
+    env:
+      # mkdocs-gen-files, literate-nav, section-index and redirects all depend on
+      # properdocs, which prints a notice about a possible MkDocs 2.0 on every
+      # build. Nothing here is acted on by it, so keep it out of the log.
+      DISABLE_MKDOCS_2_WARNING: "true"
     steps:
       - uses: actions/checkout@v7
         with:
diff --git a/docs/README.md b/docs/README.md
index 51f50b6..f24f0ff 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,3 +1,8 @@
+---
+description: >-
+  IKPyKit is a scikit-learn compatible Python library implementing Isolation Kernel methods for anomaly detection, clustering and change detection.
+---
+
 <!-- <script src="https://kit.fontawesome.com/d20edc211b.js" crossorigin="anonymous"></script>
 
 <div style="margin-bottom: 10px;">
@@ -99,8 +104,8 @@ clf.predict([[0.1, 0.3], [0, 0.7], [90, 85]])
 
 | Abbr                                                                                           | Algorithm                     | Application                                   | Publication          |
 | ---------------------------------------------------------------------------------------------- | ----------------------------- | --------------------------------------------- | -------------------- |
-| [IsoKernel](./api/kernel/isolation_kernel.md)        | Isolation Kernel              | IK feature mapping and similarity calculating | AAAI2019, SIGKDD2018 |
-| [IsoDisKernel](./api/kernel/isolation_dis_kernel.md) | Isolation Distribution Kernel | Distribution similarity calculating           | SIGKDD2020           |
+| [IsoKernel](./api/kernel/isokernel.md)        | Isolation Kernel              | IK feature mapping and similarity calculating | AAAI2019, SIGKDD2018 |
+| [IsoDisKernel](./api/kernel/isodiskernel.md) | Isolation Distribution Kernel | Distribution similarity calculating           | SIGKDD2020           |
 
 **(ii) Point Anomaly detection** :
 
@@ -123,7 +128,7 @@ clf.predict([[0.1, 0.3], [0, 0.7], [90, 85]])
 | Abbr                                                                                      | Algorithm                                                              | Application                                   | Publication |
 | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------- | ----------- |
 | [IKGOD](./api/graph/ikgod.md)                   | Subgraph Centralization: A Necessary Step for Graph Anomaly Detection. | Graph Anomaly Detection                       | SIAM2023    |
-| [IsoGraphKernel](./api/graph/IsoGraphKernel.md) | Isolation Graph Kernel                                                 | Graph IK embedding and similarity calculating | AAAI2021    |
+| [IsoGraphKernel](./api/graph/isographkernel.md) | Isolation Graph Kernel                                                 | Graph IK embedding and similarity calculating | AAAI2021    |
 
 **(V) Group Data** :
 
@@ -135,7 +140,7 @@ clf.predict([[0.1, 0.3], [0, 0.7], [90, 85]])
 
 | Abbr                                                                           | Algorithm                                                       | Application                    | Publication |
 | ------------------------------------------------------------------------------ | --------------------------------------------------------------- | ------------------------------ | ----------- |
-| [StreaKHC](./api/stream/streakhc.md) | Isolation Distribution Kernel for Trajectory Anomaly Detections | Online Hierarchical Clustering | SIGKDD2022  |
+| [StreaKHC](./api/stream/streamkhc.md) | Isolation Distribution Kernel for Trajectory Anomaly Detections | Online Hierarchical Clustering | SIGKDD2022  |
 | [ICID](./api/stream/icid.md)         | Detecting change intervals with isolation distributional kernel | Change Intervals Detection     | JAIR2024    |
 
 **(VII) Trajectory Data** :
@@ -149,7 +154,7 @@ clf.predict([[0.1, 0.3], [0, 0.7], [90, 85]])
 
 | Abbr                                                                          | Algorithm                                                       | Application       | Publication |
 | ----------------------------------------------------------------------------- | --------------------------------------------------------------- | ----------------- | ----------- |
-| [IKTOD](./api/time_series/iktod.md) | Isolation distribution kernel for Time Series Anomaly Detection | Anomaly detection | VLDB2022    |
+| [IKTOD](./api/timeseries/iktod.md) | Isolation distribution kernel for Time Series Anomaly Detection | Anomaly detection | VLDB2022    |
 
 ---
 
diff --git a/docs/api/anomaly/idkd.md b/docs/api/anomaly/idkd.md
deleted file mode 100644
index c041d25..0000000
--- a/docs/api/anomaly/idkd.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.anomaly.IDKD
diff --git a/docs/api/anomaly/iforest.md b/docs/api/anomaly/iforest.md
deleted file mode 100644
index 3a98d1c..0000000
--- a/docs/api/anomaly/iforest.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.anomaly.IForest
diff --git a/docs/api/anomaly/inne.md b/docs/api/anomaly/inne.md
deleted file mode 100644
index 676a018..0000000
--- a/docs/api/anomaly/inne.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.anomaly.INNE
diff --git a/docs/api/cluster/idkc.md b/docs/api/cluster/idkc.md
deleted file mode 100644
index b074c36..0000000
--- a/docs/api/cluster/idkc.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.cluster.IDKC
diff --git a/docs/api/cluster/ikahc.md b/docs/api/cluster/ikahc.md
deleted file mode 100644
index ee37b21..0000000
--- a/docs/api/cluster/ikahc.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.cluster.IKAHC
diff --git a/docs/api/cluster/pskc.md b/docs/api/cluster/pskc.md
deleted file mode 100644
index 61f1df6..0000000
--- a/docs/api/cluster/pskc.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.cluster.PSKC
diff --git a/docs/api/graph/IsoGraphKernel.md b/docs/api/graph/IsoGraphKernel.md
deleted file mode 100644
index 1680e6c..0000000
--- a/docs/api/graph/IsoGraphKernel.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.graph.IsoGraphKernel
diff --git a/docs/api/graph/ikgod.md b/docs/api/graph/ikgod.md
deleted file mode 100644
index a5e2c64..0000000
--- a/docs/api/graph/ikgod.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.graph.IKGOD
diff --git a/docs/api/group/ikgad.md b/docs/api/group/ikgad.md
deleted file mode 100644
index 93ef321..0000000
--- a/docs/api/group/ikgad.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.group.IKGAD
diff --git a/docs/api/kernel/isolation_dis_kernel.md b/docs/api/kernel/isolation_dis_kernel.md
deleted file mode 100644
index a9a4809..0000000
--- a/docs/api/kernel/isolation_dis_kernel.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.kernel.IsoDisKernel
diff --git a/docs/api/kernel/isolation_kernel.md b/docs/api/kernel/isolation_kernel.md
deleted file mode 100644
index 0edb0ca..0000000
--- a/docs/api/kernel/isolation_kernel.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.kernel.IsoKernel
diff --git a/docs/api/stream/icid.md b/docs/api/stream/icid.md
deleted file mode 100644
index 4271a04..0000000
--- a/docs/api/stream/icid.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.stream.ICID
diff --git a/docs/api/stream/streakhc.md b/docs/api/stream/streakhc.md
deleted file mode 100644
index bdb9f2d..0000000
--- a/docs/api/stream/streakhc.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.stream.STREAMKHC
diff --git a/docs/api/time_series/iktod.md b/docs/api/time_series/iktod.md
deleted file mode 100644
index ea3e5fd..0000000
--- a/docs/api/time_series/iktod.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.timeseries.IKTOD
diff --git a/docs/api/trajectory/data_loader/sheep_dogs.md b/docs/api/trajectory/data_loader/sheep_dogs.md
deleted file mode 100644
index bfd92b9..0000000
--- a/docs/api/trajectory/data_loader/sheep_dogs.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.trajectory.dataloader.SheepDogs
diff --git a/docs/api/trajectory/ikat.md b/docs/api/trajectory/ikat.md
deleted file mode 100644
index cde2a24..0000000
--- a/docs/api/trajectory/ikat.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.trajectory.IKAT
diff --git a/docs/api/trajectory/tidkc.md b/docs/api/trajectory/tidkc.md
deleted file mode 100644
index 1fe4ebe..0000000
--- a/docs/api/trajectory/tidkc.md
+++ /dev/null
@@ -1 +0,0 @@
-::: ikpykit.trajectory.TIDKC
diff --git a/docs/authors/authors.md b/docs/authors/authors.md
index fb0bbe3..7c44d29 100644
--- a/docs/authors/authors.md
+++ b/docs/authors/authors.md
@@ -1,3 +1,8 @@
+---
+description: >-
+  The authors and contributors behind IKPyKit, and how to get involved.
+---
+
 # Authors
 
 All contributions, bug reports, bug fixes, documentation improvements, enhancements, and ideas are welcome.
diff --git a/docs/contributing/contribution.md b/docs/contributing/contribution.md
index ea71d0c..0a56eb3 100644
--- a/docs/contributing/contribution.md
+++ b/docs/contributing/contribution.md
@@ -1,3 +1,8 @@
+---
+description: >-
+  How to contribute to IKPyKit: setting up a development environment, running the tests and opening a pull request.
+---
+
 Contributing to ikpykit
 =====================
 
diff --git a/docs/examples/examples_english.md b/docs/examples/examples_english.md
index 4ba4c95..b74bd4b 100644
--- a/docs/examples/examples_english.md
+++ b/docs/examples/examples_english.md
@@ -1,3 +1,8 @@
+---
+description: >-
+  Worked examples and tutorials showing how to apply the Isolation Kernel estimators in IKPyKit to real data.
+---
+
 <script src="https://kit.fontawesome.com/d20edc211b.js" crossorigin="anonymous"></script>
 
 # Examples and Tutorials
diff --git a/docs/faq/table-of-contents.md b/docs/faq/table-of-contents.md
index ce9f05a..65cf7b6 100644
--- a/docs/faq/table-of-contents.md
+++ b/docs/faq/table-of-contents.md
@@ -1,3 +1,8 @@
+---
+description: >-
+  Answers to common questions about installing IKPyKit, the Python versions it supports and how its models behave.
+---
+
 # Frequently Asked Questions
 
 This page collects common questions about IKPyKit usage, installation, and model behavior.
diff --git a/docs/quick-start/how-to-install.md b/docs/quick-start/how-to-install.md
index d91a31e..9fdfea2 100644
--- a/docs/quick-start/how-to-install.md
+++ b/docs/quick-start/how-to-install.md
@@ -1,3 +1,8 @@
+---
+description: >-
+  How to install IKPyKit with uv or pip, including the optional dependencies needed for the extended features.
+---
+
 # Installation Guide
 
 This guide will help you install `ikpykit`. The default installation of `ikpykit` includes only the essential dependencies required for basic functionality. Additional optional dependencies can be installed for extended features.
diff --git a/docs/releases/releases.md b/docs/releases/releases.md
index 42459f6..5a2f66d 100644
--- a/docs/releases/releases.md
+++ b/docs/releases/releases.md
@@ -1,3 +1,8 @@
+---
+description: >-
+  Changelog for IKPyKit: the features, enhancements, API changes and fixes in every release.
+---
+
 # Changelog
 
 All significant changes to this project are documented in this release file.
diff --git a/docs/user_guides/table-of-contents.md b/docs/user_guides/table-of-contents.md
index 156b0a2..4d75c81 100644
--- a/docs/user_guides/table-of-contents.md
+++ b/docs/user_guides/table-of-contents.md
@@ -1,3 +1,8 @@
+---
+description: >-
+  User guides for IKPyKit, organised by task: anomaly detection, clustering, change detection and kernel similarity.
+---
+
 # Table of Contents
 
 Welcome to the ikpykit user guides! This comprehensive collection of guides is designed to help you navigate through the various features and functionalities of ikpykit. Whether you are a beginner or an advanced user, you will find the necessary resources to master data with ikpykit. Below, you will find the user guides categorized by topic for easier navigation.
diff --git a/mkdocs.yml b/mkdocs.yml
index baab2a1..ad5b95d 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -31,33 +31,10 @@ nav:
   - Examples and tutorials:
       - Examples: examples/examples_english.md
 
-  - API Reference:
-      - Isolation Kernel:
-          - Isolation Kernel: api/kernel/isolation_kernel.md
-          - Isolation Distribution Kernel: api/kernel/isolation_dis_kernel.md
-      - Point Anomaly Detection:
-          - IForest: api/anomaly/iforest.md
-          - INNE: api/anomaly/inne.md
-          - IDKD: api/anomaly/idkd.md
-      - Point Clustering:
-          - IDKC: api/cluster/idkc.md
-          - PSKC: api/cluster/pskc.md
-          - IKAHC: api/cluster/ikahc.md
-      - Graph Mining:
-          - IKGOD: api/graph/ikgod.md
-          - IsoGraphKernel: api/graph/IsoGraphKernel.md
-      - Group Mining:
-          - IKGAD: api/group/ikgad.md
-      - Stream Mining:
-          - ICID: api/stream/icid.md
-          - StreaKHC: api/stream/streakhc.md
-      - Trajectory Mining:
-          - DataLoader:
-              - SheepDogs: api/trajectory/data_loader/sheep_dogs.md
-          - IKAT: api/trajectory/ikat.md
-          - TIDKC: api/trajectory/tidkc.md
-      - Time Series Mining:
-          - IKTOD: api/time_series/iktod.md
+  # Pages and sub-navigation are generated from the package by
+  # scripts/gen_api_pages.py; literate-nav expands this entry from the
+  # api/SUMMARY.md that script writes.
+  - API Reference: api/
 
   - Releases: releases/releases.md
 
@@ -70,6 +47,17 @@ nav:
   - Authors: authors/authors.md
 
 plugins:
+  # First, so the pages it writes are in the file collection before any plugin
+  # that looks at it: literate-nav needs api/SUMMARY.md, and the llmstxt
+  # sections below resolve their globs against that collection too.
+  - gen-files:
+      scripts:
+        - scripts/gen_api_pages.py
+  - literate-nav:
+      nav_file: SUMMARY.md
+  # Lets the generated api/index.md serve as the "API Reference" section itself,
+  # so the tab links to the overview instead of doing nothing.
+  - section-index
   - mkdocstrings:
       handlers:
         python:
@@ -141,12 +129,27 @@ plugins:
         Examples:
           - examples/*.md
         API reference:
+          # The overview needs listing on its own: the glob below only matches
+          # pages that sit in a subdirectory of api/.
+          - api/index.md
           - api/**/*.md
         Project:
           - releases/releases.md
           - faq/table-of-contents.md
           - contributing/contribution.md
           - authors/authors.md
+  # Six API pages were hand-named and no longer match what the generator derives
+  # from the class. This keeps links published against v0.3.0 and earlier
+  # working. It is a fixed list of legacy paths, not something a new estimator
+  # ever needs to be added to.
+  - redirects:
+      redirect_maps:
+        api/kernel/isolation_kernel.md: api/kernel/isokernel.md
+        api/kernel/isolation_dis_kernel.md: api/kernel/isodiskernel.md
+        api/graph/IsoGraphKernel.md: api/graph/isographkernel.md
+        api/stream/streakhc.md: api/stream/streamkhc.md
+        api/time_series/iktod.md: api/timeseries/iktod.md
+        api/trajectory/data_loader/sheep_dogs.md: api/trajectory/dataloader/sheepdogs.md
   # Downloads the external assets the pages reference (Google Fonts, the CDN
   # copy of require.js that mkdocs-jupyter pulls in) and serves them from this
   # site instead, so a visitor's browser makes no third-party requests for them.
diff --git a/pyproject.toml b/pyproject.toml
index 6164ba6..69affe7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -94,13 +94,17 @@ docs = [
     "matplotlib>=3.9.0",
     "mike==2.2.0",
     "mkdocs==1.6.1",
+    "mkdocs-gen-files==0.6.1",
     "mkdocs-git-revision-date-localized-plugin==1.5.3",
     "mkdocs-jupyter==0.26.3",
+    "mkdocs-literate-nav==0.6.3",
     "mkdocs-llmstxt==0.5.0",
     # The theme was previously only reached through mkdocs-jupyter. It is a
     # direct requirement of this site, and the imaging extra (cairosvg, pillow)
     # is what the built-in social plugin renders cards with.
     "mkdocs-material[imaging]==9.7.7",
+    "mkdocs-redirects==1.2.3",
+    "mkdocs-section-index==0.3.12",
     "mkdocstrings==1.0.6",
     "mkdocstrings-python==2.0.5",
     "notebook==7.6.2",
diff --git a/scripts/gen_api_pages.py b/scripts/gen_api_pages.py
new file mode 100644
index 0000000..db31de9
--- /dev/null
+++ b/scripts/gen_api_pages.py
@@ -0,0 +1,179 @@
+"""Generate the API reference pages, their navigation and an overview index.
+
+Every public estimator used to need a one-line stub under ``docs/api/`` and a
+matching entry in the ``nav`` of ``mkdocs.yml``. Both were easy to forget, and a
+missing one failed silently: the class simply had no page. The package already
+states what is public, through the ``__all__`` of each module, so that is what
+this script reads.
+
+The only thing it cannot derive is the section names below, which are editorial,
+and their order, which is meaningful. Adding an estimator to a module that is
+already listed needs no change here.
+
+Run by mkdocs-gen-files during the build; the pages exist only in the built site.
+"""
+
+from __future__ import annotations
+
+import importlib
+import inspect
+import json
+import re
+import textwrap
+from dataclasses import dataclass, field
+
+import mkdocs_gen_files
+from mkdocs.structure.files import InclusionLevel
+
+# Longest description to put in front matter. Social cards and search engines
+# both cut off around here, so a longer one is only truncated elsewhere.
+DESCRIPTION_LIMIT = 160
+
+API_ROOT = "api"
+
+
+@dataclass(frozen=True)
+class Section:
+    """A group of estimators shown under one heading in the navigation."""
+
+    title: str
+    module: str
+    subsections: tuple[Section, ...] = field(default_factory=tuple)
+
+
+SECTIONS = (
+    Section("Isolation Kernel", "ikpykit.kernel"),
+    Section("Point Anomaly Detection", "ikpykit.anomaly"),
+    Section("Point Clustering", "ikpykit.cluster"),
+    Section("Graph Mining", "ikpykit.graph"),
+    Section("Group Mining", "ikpykit.group"),
+    Section("Stream Mining", "ikpykit.stream"),
+    Section(
+        "Trajectory Mining",
+        "ikpykit.trajectory",
+        subsections=(Section("DataLoader", "ikpykit.trajectory.dataloader"),),
+    ),
+    Section("Time Series Mining", "ikpykit.timeseries"),
+)
+
+
+def summarize_text(text: str) -> str:
+    """Collapse text to a single line, keeping whole sentences within the limit.
+
+    Text longer than the limit is cut at the last sentence that still fits,
+    rather than mid-word.
+    """
+    line = " ".join(text.split())
+    if len(line) <= DESCRIPTION_LIMIT:
+        return line
+
+    kept = ""
+    for sentence in re.findall(r"[^.]*\.(?:\s|$)", line):
+        if len(kept) + len(sentence) > DESCRIPTION_LIMIT:
+            break
+        kept += sentence
+    # A first sentence that is itself over the limit leaves nothing to keep.
+    return kept.strip() or line[:DESCRIPTION_LIMIT].rstrip()
+
+
+def summarize(obj: object) -> str:
+    """Return the first paragraph of an object's docstring as a single line."""
+    doc = inspect.getdoc(obj) or ""
+    return summarize_text(doc.split("\n\n")[0])
+
+
+def page_path(module: str, name: str) -> str:
+    """Return the doc path for a class, mirroring its location in the package."""
+    package = module.removeprefix("ikpykit.").replace(".", "/")
+    return f"{package}/{name.lower()}.md"
+
+
+def write_page(module: str, name: str, description: str) -> None:
+    """Write the stub that mkdocstrings expands into the rendered class page."""
+    path = page_path(module, name)
+    with mkdocs_gen_files.open(f"{API_ROOT}/{path}", "w") as page:
+        # Drives the meta description, the social card and the llms.txt entry.
+        # Quoting through JSON keeps a description containing ": " or a quote
+        # from breaking the front matter.
+        page.write(f"---\ndescription: {json.dumps(description)}\n---\n\n")
+        page.write(f"::: {module}.{name}\n")
+
+
+def collect(section: Section) -> list[tuple[str, str, str]]:
+    """Return (module, name, description) for every public class in a section."""
+    module = importlib.import_module(section.module)
+    entries = []
+    for name in module.__all__:
+        obj = getattr(module, name)
+        entries.append((section.module, name, summarize(obj)))
+    return entries
+
+
+def render_nav(section: Section, depth: int = 0) -> list[str]:
+    """Render one section of the literate-nav SUMMARY, subsections first."""
+    indent = "    " * depth
+    lines = [f"{indent}* {section.title}"]
+    for subsection in section.subsections:
+        lines += render_nav(subsection, depth + 1)
+    for module, name, _ in collect(section):
+        lines.append(f"{indent}    * [{name}]({page_path(module, name)})")
+    return lines
+
+
+def render_overview(section: Section, level: int = 2) -> list[str]:
+    """Render one section of the overview page as a table of its estimators."""
+    lines = [
+        f"{'#' * level} {section.title}",
+        "",
+        "| Estimator | Description |",
+        "| --- | --- |",
+    ]
+    for module, name, description in collect(section):
+        lines.append(f"| [{name}]({page_path(module, name)}) | {description} |")
+    lines.append("")
+    for subsection in section.subsections:
+        lines += render_overview(subsection, level + 1)
+    return lines
+
+
+def main() -> None:
+    for section in SECTIONS:
+        for subsection in (section, *section.subsections):
+            for module, name, description in collect(subsection):
+                write_page(module, name, description)
+
+    with mkdocs_gen_files.open(f"{API_ROOT}/SUMMARY.md", "w") as summary:
+        summary.write("* [Overview](index.md)\n")
+        for section in SECTIONS:
+            summary.write("\n".join(render_nav(section)) + "\n")
+
+    # literate-nav reads this file and then only marks it as not-in-nav, so it
+    # would still be built, land in the sitemap and turn up in site search as a
+    # bare list of links. It is an input to the build, not a page.
+    editor = mkdocs_gen_files.FilesEditor.current()
+    nav_file = editor.files.get_file_from_path(f"{API_ROOT}/SUMMARY.md")
+    nav_file.inclusion = InclusionLevel.EXCLUDED
+
+    intro = (
+        "Every estimator IKPyKit exports, grouped by the kind of data it works "
+        "on. They all follow the scikit-learn API, so each one is constructed "
+        "with its parameters and then fitted."
+    )
+    overview = [
+        "---",
+        f"description: {json.dumps(summarize_text(intro))}",
+        "---",
+        "",
+        "# API Reference",
+        "",
+        textwrap.fill(intro, width=79),
+        "",
+    ]
+    for section in SECTIONS:
+        overview += render_overview(section)
+
+    with mkdocs_gen_files.open(f"{API_ROOT}/index.md", "w") as index:
+        index.write("\n".join(overview))
+
+
+main()
diff --git a/uv.lock b/uv.lock
index a0bf276..f5da93e 100644
--- a/uv.lock
+++ b/uv.lock
@@ -884,10 +884,14 @@ docs = [
     { name = "matplotlib" },
     { name = "mike" },
     { name = "mkdocs" },
+    { name = "mkdocs-gen-files" },
     { name = "mkdocs-git-revision-date-localized-plugin" },
     { name = "mkdocs-jupyter" },
+    { name = "mkdocs-literate-nav" },
     { name = "mkdocs-llmstxt" },
     { name = "mkdocs-material", extra = ["imaging"] },
+    { name = "mkdocs-redirects" },
+    { name = "mkdocs-section-index" },
     { name = "mkdocstrings" },
     { name = "mkdocstrings-python" },
     { name = "notebook" },
@@ -919,10 +923,14 @@ docs = [
     { name = "matplotlib", specifier = ">=3.9.0" },
     { name = "mike", specifier = "==2.2.0" },
     { name = "mkdocs", specifier = "==1.6.1" },
+    { name = "mkdocs-gen-files", specifier = "==0.6.1" },
     { name = "mkdocs-git-revision-date-localized-plugin", specifier = "==1.5.3" },
     { name = "mkdocs-jupyter", specifier = "==0.26.3" },
+    { name = "mkdocs-literate-nav", specifier = "==0.6.3" },
     { name = "mkdocs-llmstxt", specifier = "==0.5.0" },
     { name = "mkdocs-material", extras = ["imaging"], specifier = "==9.7.7" },
+    { name = "mkdocs-redirects", specifier = "==1.2.3" },
+    { name = "mkdocs-section-index", specifier = "==0.3.12" },
     { name = "mkdocstrings", specifier = "==1.0.6" },
     { name = "mkdocstrings-python", specifier = "==2.0.5" },
     { name = "notebook", specifier = "==7.6.2" },
@@ -1734,6 +1742,19 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/9f/4d/7123b6fa2278000688ebd338e2a06d16870aaf9eceae6ba047ea05f92df1/mkdocs_autorefs-1.4.3-py3-none-any.whl", hash = "sha256:469d85eb3114801d08e9cc55d102b3ba65917a869b893403b8987b601cf55dc9", size = 25034, upload-time = "2025-08-26T14:23:15.906Z" },
 ]
 
+[[package]]
+name = "mkdocs-gen-files"
+version = "0.6.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mkdocs" },
+    { name = "properdocs" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/43/43/428f312149c161cae557eecd35f3c4a82b867998b1d47fb29fdfe927be26/mkdocs_gen_files-0.6.1.tar.gz", hash = "sha256:57d7ff2229e23d077e46d14a33db6d37c8823f6ce1a503c874c1764a71679763", size = 8746, upload-time = "2026-03-16T23:26:09.31Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ee/1b/3075eb67fe66e19db059f0a25744c4e56978a309603a20e1d3353d545b5e/mkdocs_gen_files-0.6.1-py3-none-any.whl", hash = "sha256:b3182bfc6219e35b8d26658cb988368659d5d023aac30c2a819247558fc12189", size = 8282, upload-time = "2026-03-16T23:26:08.292Z" },
+]
+
 [[package]]
 name = "mkdocs-get-deps"
 version = "0.2.0"
@@ -1780,6 +1801,19 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/13/95/cf3f7fe4910cf0365fa8ea0c731f4b8a624d97cd76ea777913ac8d0868e2/mkdocs_jupyter-0.26.3-py3-none-any.whl", hash = "sha256:cd6644fb578131157194d750fd4d10fc2fd8f1e84e00036ee62df3b5b4b84c82", size = 1459740, upload-time = "2026-04-17T18:56:30.031Z" },
 ]
 
+[[package]]
+name = "mkdocs-literate-nav"
+version = "0.6.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mkdocs" },
+    { name = "properdocs" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/01/af/dd3776a7a713f798f79bec7eb9c661d5cfb83ddc17d9a3667595e53e1559/mkdocs_literate_nav-0.6.3.tar.gz", hash = "sha256:edbaca22343f861fe4e34aac47d55a0c9955c640dbf02eea99fe631e914cf9ee", size = 17526, upload-time = "2026-03-16T23:26:50.688Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/4e/2c/bcf1ae903975ad6f169abb05c1eb0f94395478364deb89270cf034081b29/mkdocs_literate_nav-0.6.3-py3-none-any.whl", hash = "sha256:2c421561280fa9184f88cbf399bebbd4cc17ee507e978a31ce11fd6f3aabf233", size = 13355, upload-time = "2026-03-16T23:26:49.562Z" },
+]
+
 [[package]]
 name = "mkdocs-llmstxt"
 version = "0.5.0"
@@ -1832,6 +1866,32 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/5b/54/662a4743aa81d9582ee9339d4ffa3c8fd40a4965e033d77b9da9774d3960/mkdocs_material_extensions-1.3.1-py3-none-any.whl", hash = "sha256:adff8b62700b25cb77b53358dad940f3ef973dd6db797907c49e3c2ef3ab4e31", size = 8728, upload-time = "2023-11-22T19:09:43.465Z" },
 ]
 
+[[package]]
+name = "mkdocs-redirects"
+version = "1.2.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mkdocs" },
+    { name = "properdocs" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/73/25/49725f78ca5d3026b09973f7a2b3a8b179cc2e8c15e43d5a13bc79f6b274/mkdocs_redirects-1.2.3.tar.gz", hash = "sha256:5e980330999299729a2d6a125347d1af78023d68a23681a4de3053ce7dfe2e51", size = 7712, upload-time = "2026-03-28T13:57:41.766Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c6/90/871b1cddc01d2ba1637b858eeeabc2e3013dc8df591306b5567b98ef0870/mkdocs_redirects-1.2.3-py3-none-any.whl", hash = "sha256:ec7312fff462d03ec16395d0c001006a418f8d0c21cdf2b47ff11cf839dc3ce0", size = 6245, upload-time = "2026-03-28T13:57:40.466Z" },
+]
+
+[[package]]
+name = "mkdocs-section-index"
+version = "0.3.12"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mkdocs" },
+    { name = "properdocs" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f1/e2/64d0f3f054ca8efe61e706006ff5f0d49ad99620c62c2e04818573391c33/mkdocs_section_index-0.3.12.tar.gz", hash = "sha256:285635bf86c643b0fc7a343053d7a818049817bff4408f52b80c4367bd5e7268", size = 14946, upload-time = "2026-04-16T19:20:00.953Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b0/4d/a330cab5e055d45e924cec69da54a3d8ed37643964f8d1fa1a772b496273/mkdocs_section_index-0.3.12-py3-none-any.whl", hash = "sha256:a1100039546beb4ebef63ce6fc91f3195fb9c0c3763105d4d3d7cd31e0a046eb", size = 8932, upload-time = "2026-04-16T19:19:59.741Z" },
+]
+
 [[package]]
 name = "mkdocstrings"
 version = "1.0.6"
@@ -2355,6 +2415,29 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/84/03/0d3ce49e2505ae70cf43bc5bb3033955d2fc9f932163e84dc0779cc47f48/prompt_toolkit-3.0.52-py3-none-any.whl", hash = "sha256:9aac639a3bbd33284347de5ad8d68ecc044b91a762dc39b7c21095fcd6a19955", size = 391431, upload-time = "2025-08-27T15:23:59.498Z" },
 ]
 
+[[package]]
+name = "properdocs"
+version = "1.6.7"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "click" },
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "ghp-import" },
+    { name = "jinja2" },
+    { name = "markdown" },
+    { name = "markupsafe" },
+    { name = "packaging" },
+    { name = "pathspec" },
+    { name = "platformdirs" },
+    { name = "pyyaml" },
+    { name = "pyyaml-env-tag" },
+    { name = "watchdog" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/ec/29/f27a4e1eddf72ed3db6e47818fbafe6debbf09fd7051f9c1a007239b46ef/properdocs-1.6.7.tar.gz", hash = "sha256:adc7b16e562890af0e098a7e5b02e3a81c20894a87d6a28d345c9300de73c26e", size = 276141, upload-time = "2026-03-20T20:07:48.167Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/bd/4d/fc923f5c85318ee8cc903566dc4e0ebe41b2dfc1d2ecf5546db232397ed6/properdocs-1.6.7-py3-none-any.whl", hash = "sha256:6fa0cfa2e01bf338f684892c8a506cf70ea88ae7f3479c933b6fa20168101cbd", size = 225406, upload-time = "2026-03-20T20:07:46.875Z" },
+]
+
 [[package]]
 name = "psutil"
 version = "7.1.3"