Goal
Classify persistent failures from the advisory External Link Check, repair a small evidence-selected set of stale references, and add narrowly scoped online-only exclusions only for URLs that automated online validation cannot meaningfully check.
Baseline
External Link Check run 34347690674 ran on develop revision 7abc30b2b9fb85b235e7b2ef2a40f5d5f7ed1555. Its report artifact contained 1,677 checks, 1,216 successes, 24 redirects, 461 errors, and no timeouts: 440 generic errors, 18 404s, and 3 403s.
The report includes dynamic GitHub review-comment fragments, intentionally unavailable localhost examples, stale repository/docs.rs references, and third-party access or fragment limitations. These categories need separate dispositions; no broad host-level suppression is acceptable.
Scope
- Record issue-local baseline and a disposition for every distinct URL or recurring failure pattern.
- Repair bounded, verified stale references.
- Add only documented, online-only exclusions for durable false-positive categories.
- Rerun the hosted workflow after each remediation slice and retain evidence.
Constraints
Verification
Run linter all, validate changed configuration/workflows, and manually dispatch the workflow. Each exclusion must be proven narrow: its intended category disappears while unrelated external failures and the report artifact remain visible.
Parent EPIC: #2003
Enabling issue: #2162
Goal
Classify persistent failures from the advisory External Link Check, repair a small evidence-selected set of stale references, and add narrowly scoped online-only exclusions only for URLs that automated online validation cannot meaningfully check.
Baseline
External Link Check run 34347690674 ran on
developrevision7abc30b2b9fb85b235e7b2ef2a40f5d5f7ed1555. Its report artifact contained 1,677 checks, 1,216 successes, 24 redirects, 461 errors, and no timeouts: 440 generic errors, 18404s, and 3403s.The report includes dynamic GitHub review-comment fragments, intentionally unavailable localhost examples, stale repository/docs.rs references, and third-party access or fragment limitations. These categories need separate dispositions; no broad host-level suppression is acceptable.
Scope
Constraints
continue-on-error, broadly exclude external hosts/fragments, replace Lychee, or change the shared linter integration.Verification
Run
linter all, validate changed configuration/workflows, and manually dispatch the workflow. Each exclusion must be proven narrow: its intended category disappears while unrelated external failures and the report artifact remain visible.Parent EPIC: #2003
Enabling issue: #2162