From ff9d29bc691143bd04f97823d958f537e6717946 Mon Sep 17 00:00:00 2001 From: Phlex Agent Date: Fri, 7 Aug 2026 12:04:00 -0400 Subject: [PATCH] docs: fix 8 dead TOC anchors on the windows client build guide MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit VitePress prefixes a heading id with `_` when the slug would start with a digit, so `## 1. Architectural Rule` emits `id="_1-architectural-rule"`. The Table of Contents at docs/dev/client-windows.md:14-21 linked the un-prefixed form for all eight numbered sections, so every TOC entry on the page was dead. The convention is already established in this repo — docs/dev/client-roku.md:8-18 uses `#_1-overview` … `#_11-device-verification-status` for the same heading style, and .claude/rules/docs-authoring.md documents the rule explicitly ("## 1. Overview -> id=\"_1-overview\""). The windows page simply diverged from it. Fixed to match, verified against the emitted ids in the built HTML rather than derived by hand. Scope is the whole defect class, not just the reported instance: a repo-wide sweep for markdown links to a digit-leading fragment (grep -rnE '\]\(#[0-9]' plus the cross-page form) returns exactly these eight links and nothing else, so no other page needs the same correction. Pages with numbered headings that already use the `#_N-` form were left alone. This unblocks publishing. `Build Docs` and `Deploy Docs` have both been failing on master for three commits (c4619dd, 75f7139, 376fbad), so the site has not deployed since fd77141 — the anchor breakage starts at 75f7139; c4619dd was an unrelated Pages deploy timeout. Verified: npm run docs:build exits 0, anchor gate reports "157 page(s), 3463 unique #fragment link(s) checked" and "0 dead anchor(s) found" in a clean tracked-files-only worktree (the corpus CI sees). Co-Authored-By: Claude Opus 5 (1M context) --- docs/dev/client-windows.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/dev/client-windows.md b/docs/dev/client-windows.md index 26658a5..8b18d0f 100644 --- a/docs/dev/client-windows.md +++ b/docs/dev/client-windows.md @@ -11,14 +11,14 @@ ## Table of Contents -1. [Architectural Rule](#1-architectural-rule) -2. [Technology Stack](#2-technology-stack) -3. [Entry Points and Boot Sequence](#3-entry-points-and-boot-sequence) -4. [The `app://` Protocol](#4-the-app-protocol) -5. [IPC Channels](#5-ipc-channels) -6. [Dependency Pinning](#6-dependency-pinning) -7. [Testing](#7-testing) -8. [Building and Releasing](#8-building-and-releasing) +1. [Architectural Rule](#_1-architectural-rule) +2. [Technology Stack](#_2-technology-stack) +3. [Entry Points and Boot Sequence](#_3-entry-points-and-boot-sequence) +4. [The `app://` Protocol](#_4-the-app-protocol) +5. [IPC Channels](#_5-ipc-channels) +6. [Dependency Pinning](#_6-dependency-pinning) +7. [Testing](#_7-testing) +8. [Building and Releasing](#_8-building-and-releasing) ---