From ee1c9d576b24b18abbecea236f150e1aa7cf0ee1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mat=C3=A9o=20H=2E=20Petel?=
 <113530345+fraware@users.noreply.github.com>
Date: Mon, 12 Oct 2026 09:35:32 -0700
Subject: [PATCH] fix(docs): publish root landing page and verify deployment
 entrypoint

---
 .github/workflows/docs-check.yml |  5 ++++-
 .github/workflows/docs.yml       |  5 ++++-
 docs/index.md                    | 15 +++++++++++++++
 mkdocs.yml                       |  2 +-
 4 files changed, 24 insertions(+), 3 deletions(-)
 create mode 100644 docs/index.md

diff --git a/.github/workflows/docs-check.yml b/.github/workflows/docs-check.yml
index 4000d231..c796dd94 100644
--- a/.github/workflows/docs-check.yml
+++ b/.github/workflows/docs-check.yml
@@ -26,7 +26,10 @@ jobs:
       - name: Install documentation dependencies
         run: python -m pip install -e '.[docs,env]'
       - name: Verify documentation and internal links
-        run: mkdocs build --strict --site-dir /tmp/labtrust-mkdocs-ci
+        run: |
+          mkdocs build --strict --site-dir /tmp/labtrust-mkdocs-ci
+          test -s /tmp/labtrust-mkdocs-ci/index.html
+          test -s /tmp/labtrust-mkdocs-ci/getting-started/index.html
       - name: Checkout pinned PCS dependency for release viewer
         uses: actions/checkout@v4
         with:
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 414ac069..853c05be 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -29,7 +29,10 @@ jobs:
         run: pip install -e '.[docs,env]'
 
       - name: Build MkDocs
-        run: mkdocs build --strict
+        run: |
+          mkdocs build --strict
+          test -s site/index.html
+          test -s site/getting-started/index.html
 
       - name: Checkout pinned PCS dependency for release viewer
         uses: actions/checkout@v4
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 00000000..8c060cb8
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,15 @@
+# LabTrust-Gym
+
+LabTrust-Gym is a multi-agent environment for hospital laboratory automation, with benchmarks for coordination, operational policy, risk, and security.
+
+## Start here
+
+- [Getting started](getting-started/index.md) — installation, first experiments, and demonstrations.
+- [Architecture](architecture/index.md) — environment design and execution model.
+- [Benchmarks and studies](benchmarks/index.md) — evaluation procedures, results, and reproduction.
+- [Coordination](coordination/index.md) — multi-agent coordination methods and experiments.
+- [Risk and security](risk-and-security/index.md) — risk models, security tests, and controls.
+- [Proof-Carrying Science](pcs/index.md) — scientific evidence and release workflows.
+- [Operations](operations/index.md) — CI, releases, and operational guidance.
+
+For source code and issue tracking, see the [LabTrust-Gym repository](https://github.com/fraware/LabTrust-Gym).
diff --git a/mkdocs.yml b/mkdocs.yml
index a7700f81..0f131f62 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -13,7 +13,7 @@ theme:
   highlightjs: true
 
 nav:
-  - Overview: getting-started/index.md
+  - Overview: index.md
   - Getting started:
     - getting-started/index.md
     - Installation: getting-started/installation.md