Merge pull request #11 from flyingrobots/echo/docs-make-open

echo/docs make open

Author: flyingrobots

Makefile

@@ -4,7 +4,6 @@ SHELL := /bin/bash
 PORT ?= 5173
 
 .PHONY: hooks docs docs-build docs-ci
-
 hooks:
 	@git config core.hooksPath .githooks
 	@chmod +x .githooks/* 2>/dev/null || true
@@ -26,7 +25,7 @@ docs:
 	      wait $$server_pid ; \
 	      exit 0 ; \
 	    fi ; \
-	    sleep 0.25 ; \
+	    sleep 1 ; \
 	  done ; \
 	  echo "[docs] Timed out waiting for VitePress." ; \
 	  exit 1

docs/.vitepress/config.ts

@@ -4,6 +4,10 @@ export default defineConfig({
   title: 'Echo',
   description: 'Deterministic, multiverse-aware ECS',
   cleanUrls: true,
+  ignoreDeadLinks: [
+    // Collision tour HTML is added in a separate PR
+    /^\/collision-dpo-tour\.html$/
+  ],
   themeConfig: {
     nav: [
       { text: 'Home', link: '/' },
@@ -21,4 +25,7 @@ export default defineConfig({
     }
   }
 })
+<<<<<<< HEAD
+=======
 
+>>>>>>> origin/main

docs/decision-log.md

@@ -60,3 +60,12 @@
 - Decision: Do not disable Prev/Next in "all" mode; allow navigation buttons to toggle into carousel.
 - Change: docs/assets/collision/animate.js leaves Prev/Next enabled in 'all'; boundary disabling still applies in single-slide mode.
 - Consequence: Users can initiate the carousel via navigation controls; E2E tour test passes deterministically.
+
+## 2025-10-29 — Docs make open (PR #11)
+
+- Context: Make dev docs open automatically; fix routing and dead-link noise.
+- Decisions:
+  - Use a precise dead-link ignore for `/collision-dpo-tour.html` (exact regex) until the page is always present.
+  - Convert tour/spec links to root‑relative paths to work site‑wide under VitePress routing.
+  - Make the dev server polling loop portable (`sleep 1`).
+- Consequence: Docs dev flow is consistent across environments; CI Docs Guard happy; links resolve from any page.

docs/execution-plan.md

@@ -33,6 +33,11 @@ This is Codex’s working map for building Echo. Update it relentlessly—each s
 
 ## Today’s Intent
 
+> 2025-10-29 — Docs make open (PR #11)
+
+- VitePress dev: keep auto-open; polling loop uses portable `sleep 1`.
+- Fix links and dead-link ignore: root-relative URLs; precise regex for `/collision-dpo-tour.html`; corrected comment typo.
+
 > 2025-10-29 — Docs E2E (PR #10)
 
 - Collision DPO tour carousel: keep Prev/Next enabled in "all" mode so users and tests can enter carousel via navigation. Fixes Playwright tour test.

docs/guide/collision-tour.md

@@ -6,8 +6,7 @@ title: Collision DPO Tour
 
 The interactive tour illustrates how Echo models collision and CCD as DPO graph rewrites.
 
-- Launch the tour: [docs/collision-dpo-tour.html](../collision-dpo-tour.html)
+- Launch the tour: [docs/collision-dpo-tour.html](/collision-dpo-tour.html)
 - Assets live under `docs/assets/collision/`.
 
 Tip: Toggle the World/Graph tabs in the picture-in-picture panel and use the Prev/Next buttons to step through each rule.
-

docs/index.md

@@ -6,6 +6,5 @@ title: Echo Docs
 
 Deterministic, multiverse-aware ECS.
 
-- See the Collision DPO Tour: [Open the interactive HTML](./collision-dpo-tour.html).
-- Read the spec: [Geometry & Collision](./spec-geom-collision.md).
-
+- See the Collision DPO Tour: [Open the interactive HTML](/collision-dpo-tour.html).
+- Read the spec: [Geometry & Collision](/spec-geom-collision.md).