feat(wiki-lint): check #4 — top-level docs dangling links #227

Merged

clawdie merged 1 commit from fix/wiki-lint-cover-top-level-docs into main

2026-06-26 22:11:14 +02:00

clawdie commented

2026-06-26 22:10:49 +02:00

Owner

Add check #4: scan docs/*.md for two doc-reference patterns and
verify they resolve (relative to docs/ or repo root):

a) markdown links label — the exact #224 bug class
b) backtick SHOUTING-CASE .md refs (e.g. FOO-BAR.md)

Scoped to doc-to-doc references deliberately. External URLs, anchors,
and cross-repo paths are skipped, and bare lowercase source filenames
(env.sh, build.sh — often runtime/contextual) are out of scope, so
the check has zero false positives on current main (171 pass) and
fail-closes under --strict (which CI already runs).

Calibrated by injecting fake removed-doc links: both the markdown
link and the backtick doc-name ref are detected and exit non-zero.

(Sam & Claude)

PR #224 fixed two stale references to removed docs by hand. The root cause: wiki-lint only validated docs/wiki/, never the top-level docs/*.md — so a doc could link to a removed sibling forever with nothing to catch it. Add check #4: scan docs/*.md for two doc-reference patterns and verify they resolve (relative to docs/ or repo root): a) markdown links [label](local.md) — the exact #224 bug class b) backtick SHOUTING-CASE .md refs (e.g. `FOO-BAR.md`) Scoped to doc-to-doc references deliberately. External URLs, anchors, and cross-repo paths are skipped, and bare lowercase source filenames (env.sh, build.sh — often runtime/contextual) are out of scope, so the check has zero false positives on current main (171 pass) and fail-closes under --strict (which CI already runs). Calibrated by injecting fake removed-doc links: both the markdown link and the backtick doc-name ref are detected and exit non-zero. (Sam & Claude)

clawdie added 1 commit 2026-06-26 22:10:52 +02:00

feat(wiki-lint): check #4 — top-level docs dangling links

CI / rust (pull_request) Waiting to run

Details

CI / markdown (pull_request) Waiting to run

Details

CI / port (pull_request) Waiting to run

Details

CI / agent-jail-pkgs (pull_request) Waiting to run

Details

8ffbf09f12

PR #224 fixed two stale references to removed docs by hand. The root
cause: wiki-lint only validated docs/wiki/, never the top-level
docs/*.md — so a doc could link to a removed sibling forever with
nothing to catch it.

Add check #4: scan docs/*.md for two doc-reference patterns and
verify they resolve (relative to docs/ or repo root):

  a) markdown links [label](local.md) — the exact #224 bug class
  b) backtick SHOUTING-CASE .md refs (e.g. `FOO-BAR.md`)

Scoped to doc-to-doc references deliberately. External URLs, anchors,
and cross-repo paths are skipped, and bare lowercase source filenames
(env.sh, build.sh — often runtime/contextual) are out of scope, so
the check has zero false positives on current main (171 pass) and
fail-closes under --strict (which CI already runs).

Calibrated by injecting fake removed-doc links: both the markdown
link and the backtick doc-name ref are detected and exit non-zero.

(Sam & Claude)