Skip to content

docs: fix 4 stale external links surfaced by working lychee#263

Merged
Destynova2 merged 1 commit intomainfrom
fix/lychee-stale-external-links
Apr 25, 2026
Merged

docs: fix 4 stale external links surfaced by working lychee#263
Destynova2 merged 1 commit intomainfrom
fix/lychee-stale-external-links

Conversation

@Destynova2
Copy link
Copy Markdown
Contributor

Summary

Follow-up to #261. Now that lychee actually executes (the --exclude-mail flag was crashing it before any link check), it surfaces 4 stale references that existed silently on main for a while.

  • ADR-0018 (docs/decisions/0018-nature-inspired-routing.md) — Envoy arch_overview URL had a duplicated path segment (/intro/arch_overview/intro/arch_overview/intro/arch_overview/intro/intro).
  • docs/how-to/oauth-setup.mdsst/opencode-anthropic-auth was renamed/absorbed into sst/opencode.
  • docs/reference/owasp-llm-top10.md — OWASP renamed LLM02 to llm022025-* in their 2025 list. LLM01 is unchanged on their side, so kept as-is.
  • docs/reference/benchmarks.md — replaced 4× [grob-bench](https://github.com/azerozero/grob-bench) placeholder (repo doesn't exist) with a relative link to the actual bench code in this repo (benches/).

All 4 candidate URLs were probed with curl -I to confirm they return 200 before being committed.

Test plan

  • curl -I confirms each replacement URL returns 200
  • CI: Broken link check (lychee) green
  • CI: markdownlint green (no MD changes that affect lint)

Now that lychee actually runs (--exclude-mail flag was crashing it
before any link was checked), it surfaces 4 stale references that
existed silently on main:

- ADR-0018: Envoy arch_overview URL had a duplicated path segment
  (/intro/arch_overview/intro/arch_overview -> /intro/arch_overview/intro/intro).
- oauth-setup: sst/opencode-anthropic-auth was renamed/absorbed into
  sst/opencode.
- owasp-llm-top10: OWASP renamed LLM02 to llm022025-* in the 2025 list
  (LLM01 unchanged, kept as-is).
- benchmarks: replaced 4x [grob-bench] external repo placeholder with
  a relative link to the actual bench code in this repo (benches/).
@Destynova2 Destynova2 enabled auto-merge April 25, 2026 15:16
@Destynova2 Destynova2 merged commit b8f7f1d into main Apr 25, 2026
28 of 29 checks passed
@Destynova2 Destynova2 deleted the fix/lychee-stale-external-links branch April 25, 2026 15:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant