Skip to content

[CTX-0077] docs(links): retarget published-page links away from withheld/excluded targets - #141

Merged
Xuepoo merged 1 commit into
mainfrom
ctx-0077/fix-published-dead-links
Oct 4, 2026
Merged

Xuepoo merged 1 commit into
mainfrom
ctx-0077/fix-published-dead-links

Conversation

@Xuepoo

@Xuepoo Xuepoo commented Oct 4, 2026

Copy link
Copy Markdown
Contributor

Closes #107.

Priority: P2 | Area: docs | Labels: fix, P2, area:docs | Milestone: v0.1.0 | RFC: OQ-7 | Task: CTX-0077

Problem

26+ published plugin-corpus pages linked to withheld/excluded pages, so site readers hit 404s (website T6 audit: 198 new dead-internal-link warnings on the newly published plugin pages).

Fix (issue option 1: fix the links)

Enumerated every outbound Markdown link from all 28 website-eligible pages (website_publish:true + passes the website#97 rule) and classified targets: 76 instances across 15 source files pointed at withheld (runtime/*-rfc, packaging/*-rfc, index READMEs, specifications/manifest-capability-authority) or excluded (product/plugin-roadmap, extensibility candidates, sdk/net-request-surface-candidate, architecture/diagrams/README, docs/ tree) targets.

  • Retargeted 6 links to published equivalents: runtime/packaging index links to the published contract pages, faq candidate bullet to the UI extensibility architecture, RC-5 resource-ceiling anchor to Host Runtime A.6 budgets.
  • Unlinked the remaining 70 to plain document names with prose repair (no bare deletions; sentences and table cells stay grammatical). Accepted-status claims are preserved as corpus text without a dead link.

No website_publish flips: publication eligibility stays owned by the website#97 rule; the withhold list is unchanged.

Verification

  • Publication-aware enumeration script (eligible sources x resolvable targets): 76 before, 0 after (inline + reference-style links).
  • just check green in the worktree (fmt-check, markdownlint, links, metadata, language, agents, hygiene, svg, actionlint - 103 files, 0 issues).
  • act -n -W .github/workflows/ci.yml dry-run succeeds.
  • Independent review requested before merge. Do NOT merge yet.

…eld/excluded targets

Closes #107. Published pages linked to withheld/excluded pages (website
404s). Retargeted 6 links to published equivalents; unlinked the rest to
plain document names with prose repair. Enumeration over all
website-eligible pages reports zero published->unpublished links.
@Xuepoo Xuepoo added this to the v0.1.0 milestone Oct 4, 2026
@Xuepoo Xuepoo added fix Bug fix P2 Priority: medium area:docs Documentation area labels Oct 4, 2026
@Xuepoo
Xuepoo merged commit fb45dc1 into main Oct 4, 2026
4 checks passed
@Xuepoo
Xuepoo deleted the ctx-0077/fix-published-dead-links branch October 4, 2026 23:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs Documentation area fix Bug fix P2 Priority: medium

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Published plugin pages link to withheld/excluded pages, so readers hit 404s

1 participant