Fix GitHub Pages root landing page and enforce entrypoint checks

.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:

.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

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).

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