Skip to content

fix(citations): refresh moved MDN reference paths#57

Merged
jdevalk merged 1 commit into
mainfrom
fix/mdn-reference-path-refresh-2026-06-25
Jun 25, 2026
Merged

fix(citations): refresh moved MDN reference paths#57
jdevalk merged 1 commit into
mainfrom
fix/mdn-reference-path-refresh-2026-06-25

Conversation

@jdevalk

@jdevalk jdevalk commented Jun 25, 2026

Copy link
Copy Markdown
Owner

What

Refreshes 24 MDN citations across 20 spec pages to MDN's current canonical URLs, after MDN reorganised its reference tree:

Old path New canonical path
/Web/HTTP/Headers/… /Web/HTTP/Reference/Headers/…
/Web/HTML/Global_attributes/… /Web/HTML/Reference/Global_attributes/…
/Web/CSS/CSS_logical_properties_and_values /Web/CSS/Guides/Logical_properties_and_values

The header move covers nested directive pages too (e.g. Content-Security-Policy/frame-ancestors, Content-Security-Policy/upgrade-insecure-requests).

Why now

This was surfaced by the daily standards scan's rotating stale-citation check. The old paths still 302-redirect, so they 200 after a hop and the new linkinator CI (added in fd35ce4) does not flag them — but they're no longer canonical, and MDN does eventually retire old redirects. Each redirect target was verified live (e.g. …/Web/HTTP/Headers/Cache-Control…/Web/HTTP/Reference/Headers/Cache-Control) before editing. Pure URL canonicalisation — no page content, status, or updated dates changed.

Pages touched (20)

document-language, hidden-until-found, markdown-source-endpoints, html-lang, lang-attribute, locale-content, rtl-support, cache-control, compression, http3, no-vary-search, content-security-policy, cookie-attributes, frame-ancestors, hsts, mixed-content, permissions-policy, referrer-policy, x-content-type-options, well-known-overview.

Verification

npm run build passes (149 pages, OKF reference concepts regenerate from the new URLs). npm run format:check clean. npm run lint 0 errors (1 pre-existing warning in an unrelated .astro file). No stale paths remain (grep clean).

Opened as a draft for maintainer review — not for auto-merge.

🤖 Generated with Claude Code

MDN reorganised its reference tree: HTTP header pages moved under
/Web/HTTP/Reference/Headers/, HTML global attributes under
/Web/HTML/Reference/Global_attributes/, and CSS logical properties to
/Web/CSS/Guides/Logical_properties_and_values. The old paths still
302-redirect (so linkinator CI passes), but the citations now point at
the current canonical URLs. Verified each redirect target; content
unchanged.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying specification-website with  Cloudflare Pages  Cloudflare Pages

Latest commit: d9b7081
Status: ✅  Deploy successful!
Preview URL: https://2df0ba35.specification-website.pages.dev
Branch Preview URL: https://fix-mdn-reference-path-refre.specification-website.pages.dev

View logs

@jdevalk jdevalk marked this pull request as ready for review June 25, 2026 07:23
@jdevalk jdevalk merged commit 4185d2b into main Jun 25, 2026
8 checks passed
@jdevalk jdevalk deleted the fix/mdn-reference-path-refresh-2026-06-25 branch June 25, 2026 07:23
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