Check pr for removed/changed paths #356

Activity

1. heskew

   added

   platform🖥️ Site functionality issues and requests - search, navigation, mobile, or site features🖥️ Site functionality issues and requests - search, navigation, mobile, or site features

   enhancement

   on Oct 17, 2025
2. Ethan-Arrowood

   added the

   Feature

   issue type on Jun 25, 2026
3. Ethan-Arrowood

   removed

   enhancement

   on Jun 25, 2026
4. Ethan-Arrowood

   added a parent issue on Jun 25, 2026

   • Documentation: site & tooling #550
5. Ethan-Arrowood commented on Aug 27, 2026

   

   Ethan-Arrowood

   on Aug 27, 2026

   Member

   More actions

   Folding a related finding in here, since it is the same class of problem — a link that silently stops resolving and nothing catches it.

   onBrokenAnchors is never set, so it defaults to warn. docusaurus.config.ts:57 sets onBrokenLinks: 'throw', and onBrokenMarkdownLinks: 'warn' is set on the plugin, but broken anchors are unconfigured. So a link to a heading that no longer exists builds green.

   Two are live on main right now, both found while verifying unrelated PRs:

   • reference/backups/overview.md:35 -> ../cli/commands.md#backing-up-with-volume-snapshots — no such heading exists in that file
   • release-notes/v5-lincoln/5.1.md:160 -> #deployment-operations — a same-page anchor that does not exist, and the sentence says the target is the Operations API reference

   Both are being fixed in a link-hygiene PR. Once they are clean, onBrokenAnchors: 'throw' becomes safe to turn on, and that belongs in this issue's scope: it closes the intra-repo half of the gap for free, while the redirect-coverage check this issue describes handles inbound links from outside the site.

   So this issue has two deliverables rather than one:

   1. CI redirect coverage for removed/renamed paths — the original ask. scripts/verify-redirects.mjs already exists and checks configured from paths against the live site; what is missing is the inverse, detecting that a PR removed or renamed a path without adding a redirect.
   2. onBrokenAnchors: 'throw' — cheap, mechanical, catches the in-repo case, gated only on the two fixes above landing.

   _{sent with Claude Opus 5}