From 16ea94242b556f2ad5788e12fb14de7e081e5551 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 19 May 2026 02:02:52 +0000
Subject: [PATCH] Fix docs 404: set root_doc=index, add repo-root index.md as
 entry point

Agent-Logs-Url: https://github.com/beykyle/jitr/sessions/b2433332-138d-4788-961e-9d3ba4379a71

Co-authored-by: beykyle <22779182+beykyle@users.noreply.github.com>
---
 docs/conf.py |  3 ++-
 index.md     | 25 +++++++++++++++++++++++++
 2 files changed, 27 insertions(+), 1 deletion(-)
 create mode 100644 index.md

diff --git a/docs/conf.py b/docs/conf.py
index 812ef8c..771a6d9 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -33,7 +33,7 @@
     "undoc-members": False,
 }
 
-root_doc = "docs/index"
+root_doc = "index"
 templates_path = ["_templates"]
 exclude_patterns = [
     ".git",
@@ -45,6 +45,7 @@
     "dist",
     "docs/_build",
     "docs/_build/**",
+    "docs/index.md",
     "CHANGELOG.rst",
     "README.md",
     "SUPPORT.rst",
diff --git a/index.md b/index.md
new file mode 100644
index 0000000..664724c
--- /dev/null
+++ b/index.md
@@ -0,0 +1,25 @@
+# Documentation site for `jitr`
+
+`jitr` is a calculable R-matrix toolkit for nuclear-reaction modeling,
+uncertainty propagation, and optical-potential workflows.
+
+## Documentation
+
+If you are new to the project, start with
+[Getting started](docs/getting-started.md), then browse the curated
+[example notebooks](docs/examples/index.md), and use the
+[API reference](docs/api/index.md) when you want implementation details.
+
+
+## Site Contents
+```{toctree}
+:maxdepth: 2
+:titlesonly:
+:caption: Documentation
+
+docs/getting-started
+docs/tests
+docs/advanced-users
+docs/api/index
+docs/examples/index
+```