From 525c5571ef95d9297c79afcfb5ba36a6bcb939ce Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sat, 22 Aug 2026 11:32:59 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=84=20Reconnect=20the=20docs=20"Next"?=
 =?UTF-8?q?=20chain=20to=20the=20sidebar=20order?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Next card at the foot of each documentation page skipped three
pages. Components jumped straight to Exec & Eval, and LLM providers
jumped to Reference, so Control flow, Coding agents and Journal gates
were reachable only from the sidebar — a reader following Next from
Getting started never saw them.

Point each card at the next page in the sidebar's NAV order and add the
three cards that were missing, so the chain now runs Getting started →
Components → Control flow → Exec & Eval → LLM providers → Coding agents
→ Journal gates → Reference, with Reference terminal as before.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0125zbFPKdEhKdUJxuRufpfj
---
 site/routes/docs/agents.tsx       | 3 +++
 site/routes/docs/components.tsx   | 2 +-
 site/routes/docs/control-flow.tsx | 3 +++
 site/routes/docs/journal.tsx      | 3 +++
 site/routes/docs/providers.tsx    | 2 +-
 5 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/site/routes/docs/agents.tsx b/site/routes/docs/agents.tsx
index 184595bd4..265604d68 100644
--- a/site/routes/docs/agents.tsx
+++ b/site/routes/docs/agents.tsx
@@ -1,5 +1,6 @@
 import { define } from "../../utils.ts";
 import { CodeBlock } from "../../components/Code.tsx";
+import { NextCard } from "../../components/NextCard.tsx";
 
 const REVIEW = `<Agent>
   <Session name="review">
@@ -177,6 +178,8 @@ export default define.page(function Agents() {
         workflow and includes an advanced ACPX walkthrough for client
         integration work.
       </p>
+
+      <NextCard href="/docs/journal" label="Journal gates" />
     </>
   );
 });
diff --git a/site/routes/docs/components.tsx b/site/routes/docs/components.tsx
index 94d5cd7c6..8606ee957 100644
--- a/site/routes/docs/components.tsx
+++ b/site/routes/docs/components.tsx
@@ -946,7 +946,7 @@ export default define.page(function Components() {
         </li>
       </ul>
 
-      <NextCard href="/docs/exec-eval" label="Exec & Eval" />
+      <NextCard href="/docs/control-flow" label="Control flow" />
     </>
   );
 });
diff --git a/site/routes/docs/control-flow.tsx b/site/routes/docs/control-flow.tsx
index 4aa4a80a6..9e1773678 100644
--- a/site/routes/docs/control-flow.tsx
+++ b/site/routes/docs/control-flow.tsx
@@ -1,5 +1,6 @@
 import { define } from "../../utils.ts";
 import { CodeBlock } from "../../components/Code.tsx";
+import { NextCard } from "../../components/NextCard.tsx";
 
 const SIMPLE = `<If condition={hasFailures}>
 ## Test failures
@@ -345,6 +346,8 @@ export default define.page(function ControlFlow() {
         replays what completed and executes the rest live. Which one happened is
         runtime knowledge, not journal state.
       </p>
+
+      <NextCard href="/docs/exec-eval" label="Exec & Eval" />
     </>
   );
 });
diff --git a/site/routes/docs/journal.tsx b/site/routes/docs/journal.tsx
index 218f31cd0..8ce963e44 100644
--- a/site/routes/docs/journal.tsx
+++ b/site/routes/docs/journal.tsx
@@ -1,5 +1,6 @@
 import { define } from "../../utils.ts";
 import { CodeBlock } from "../../components/Code.tsx";
+import { NextCard } from "../../components/NextCard.tsx";
 
 const OBSERVE = `import { execute } from "@executablemd/core";
 import { guardDurableStream, serializeDurableEvent } from "@executablemd/durable-streams";
@@ -75,6 +76,8 @@ export default define.page(function Journal() {
         persisted, and replay never re-runs it: restoring a journal reads
         through <code>readAll()</code>, which delegates straight to the backend.
       </p>
+
+      <NextCard href="/docs/reference" label="Reference" />
     </>
   );
 });
diff --git a/site/routes/docs/providers.tsx b/site/routes/docs/providers.tsx
index d4bfbd06a..fb1a01054 100644
--- a/site/routes/docs/providers.tsx
+++ b/site/routes/docs/providers.tsx
@@ -77,7 +77,7 @@ export default define.page(function Providers() {
         (so <code>--component-dir</code> isn't required) is on the roadmap.
       </p>
 
-      <NextCard href="/docs/reference" label="Reference" />
+      <NextCard href="/docs/agents" label="Coding agents" />
     </>
   );
 });