Repository navigation
docs: fix the dead links the online link check reports - #15477
Conversation
The weekly online link check has failed every run; run 42809150911 listed 63 dead-link locations. 40 sit in eval cases, which the standards caller now skips (melodic-software/standards#990). This fixes the rest: renamed anchors on code.claude.com and platform.claude.com, fragments only JavaScript renders (staticcheck, Chrome DevTools, Apple HIG, unversioned npm docs), moved Bun and refusals pages, a deleted x.com reply, an expired run link, a removed skill linked at its last commit, and placeholder URLs moved into code spans. Two live pages that refuse the runner get exact .lycheeignore entries. maintenance-file-dead-links.yml listens for the link check under both its current and its renamed name, so the rename in standards#990 does not disconnect it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VQb9Q2ceZLXhTR4d1vkTCe
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VQb9Q2ceZLXhTR4d1vkTCe
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 83b5658ce0
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Lane-Activity: pr-refine/fix-docs
A skill pointer must name its section (.claude/rules/skill-bodies-state-current-rules.md), so the staticcheck, Chrome DevTools Protocol and Apple HIG anchors return. lychee reads the served HTML, where those pages carry no heading ids, so each exact URL gets a .lycheeignore entry with its reason. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VQb9Q2ceZLXhTR4d1vkTCe
… docs/fix-online-dead-links
|
claude-security-review reviewed Security review: PR #15477, head ad06905No security issues found. I read every hunk in the full diff. That covers 21 distinct file changes, plus the 12 changeset fragments listed in critical-findings: 0 What I checked
Earlier threads and findings
Notes
|
|
claude-review reviewed Code review: docs: fix the dead links the online link check reportsBlocking only. This lane already reviewed an earlier head ( What I read. I read every hunk of the 33 changed files. The 12 Earlier findings
Checked
Not verified. I had no network access, so I could not check that the new anchor ids are live. That covers Other notes
|
|
The pr-verify verifier failed head This pull request leaves the merge queue, and ci-status holds it out while it carries |
The absorb-upstream record template goes back to a markdown link, so filled records keep the link form the existing records use; its unfilled placeholder URL gets an exact .lycheeignore entry. The code-tidying and playwright fragments go: since the anchors were restored, this branch no longer changes those plugins. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VQb9Q2ceZLXhTR4d1vkTCe
No related issue: owner decision Q14 (failing workflows). The owner decided to investigate and fix each failing scheduled workflow; this PR covers the online link check, which has failed every run.
Summary
Run 42809150911 of the online link check reported 63 dead-link locations. 40 are eval-case test data, which melodic-software/standards#990 excludes from the check. This PR fixes the other 23 in this repository's own content. The bot-filed dead-link rollup (issue 15082) closes itself once the link check runs clean.
Fix
.lycheeignoreentries; the npmnpxpointer moves to the versioned page, which serves its anchor.bun.com/docs/bundler#bytecode); the Fable 5.1 refusals pointer inaudit-instructions/reference/criteria.mdnow points at the refusals and fallback page, which lists Fable 5.1 and thereasoning_extractioncategory.resolve-conflictsskill is linked at its last commit.acme/skillsexample inabsorb-upstream's SKILL.md is now a code span; the record template keeps its link, and its unfilled placeholder URL gets an exact.lycheeignoreentry.color.mdandinvocation-probes.md; meaning unchanged..lycheeignoreentries with dated reasons.maintenance-file-dead-links.ymltriggers on both the current and the renamed workflow name, so standards#990's rename does not disconnect it.Done when
.lycheeignoreentry.maintenance-file-dead-links.ymltriggers on the link check under its renamed name.Verification
lychee --config lychee.tomlover every changed markdown file: 1152 links, 0 errors.--exclude-file .lycheeignoreoverdocs/standards/design-for-change.mdanddocs/cloud-sessions.md: 0 errors.scripts/check-changelog-fragments.sh --check-required origin/mainand--check: pass.scripts/check-affected.sh: 14 passed, 2 skipped.actionlintonmaintenance-file-dead-links.yml: clean.Related
maintenance-file-dead-links.yml; this PR edits only itsworkflows:trigger line and header comment.🤖 Generated with Claude Code
https://claude.ai/code/session_01VQb9Q2ceZLXhTR4d1vkTCe