Skip to content

Relink spec URL fragments that webref no longer knows - #4321

Open
schalkneethling wants to merge 2 commits into
web-platform-dx:mainfrom
schalkneethling:fix-spec-url-fragments
Open

schalkneethling wants to merge 2 commits into
web-platform-dx:mainfrom
schalkneethling:fix-spec-url-fragments

Conversation

@schalkneethling

@schalkneethling schalkneethling commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Progress on #84. Companion to #4320 — updates the 28 spec URLs whose fragments are unknown to w3c/webref, relinking to current ids rather than asking webref to carry legacy aliases, as suggested by @tidoust.

Every replacement was verified against @webref/xref lookup() with BCD's options. Buckets:

  • Renamed/moved anchors — e.g. css-anchor-position-1/#anchoring#anchor-positioning, text-fit moved from css-text-4 to css-text-5, css-contain-3 content moved back to css-contain-2.
  • ecma262 legacy @@-style ids → current %Symbol.…% ids (e.g. #sec-map.prototype-@@iterator#sec-map.prototype-%25symbol.iterator%25).
  • Fragments dropped where no meaningful anchor exists: javascript and intl intro links, GIF's spec-gif89a.txt#top (a plain-text file), and typed-arrays' #table-49 (removed; the #sec-typedarray-constructors link on the next line already covers it).
  • The lone #ref-for-… id (wasm-bigint) → the "i64" ValueType dfn.

4 warnings intentionally remain: template-for (the dfn exists in the live HTML spec; webref's weekly crawl hasn't caught up), soft-navigations/interaction-contentful-paint (spec standing is pending, so standing: "good" excludes it regardless of fragment), and html-wrapper-methods (webref doesn't extract headings for ecma262 annex pages).

Update 28 spec URLs whose fragments are legacy alias ids, renamed
anchors, or moved definitions, so they target ids that w3c/webref
records. Follows the approach suggested in web-platform-dx#84: update links to
current ids rather than asking webref to carry legacy aliases.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Fj5YkGFX6Jy2Db9UWHwxcE
@github-actions github-actions Bot added the feature definition Creating or defining new features or groups of features. label Sep 4, 2026
@tidoust

tidoust commented Sep 8, 2026

Copy link
Copy Markdown
Member

(webref doesn't extract headings for ecma262 annex pages).

And that's a bug ;)
I filed w3c/reffy#2154

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature definition Creating or defining new features or groups of features.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants