Skip to content

docs(conformance): name WPT suites after upstream .any.js runners#4

Merged
chad-loder merged 1 commit into
mainfrom
docs/wpt-suite-names
May 12, 2026
Merged

docs(conformance): name WPT suites after upstream .any.js runners#4
chad-loder merged 1 commit into
mainfrom
docs/wpt-suite-names

Conversation

@chad-loder
Copy link
Copy Markdown
Owner

Summary

Rename suite titles to upstream WPT runner basenames so a WHATWG / WPT contributor recognizes them on sight:

Was Now
Data corpus urlpattern.any.js
Constructor edge cases urlpattern-constructor.any.js
hasRegExpGroups semantics urlpattern-hasregexpgroups.any.js
compareComponent (tentative spec) urlpattern-compare.tentative.any.js
generate (tentative spec) urlpattern-generate.tentative.any.js

Three secondary improvements:

  1. WPT_REF SHA in the report header, read from git -C reference/wpt rev-parse HEAD so it can never disagree with the bytes actually tested.
  2. All upstream links now pin to the WPT_REF (was master). A committee member reading the report a year from now still sees the exact files we ran against.
  3. Fixed a pre-existing broken link for the constructor suite. The old template assumed every source file was at urlpattern/resources/<file>, but .any.js runners live at urlpattern/<file>.any.js. New shape: Runner: <runner-url> + optional · Data: <data-url>.

Test plan

  • just compliance-report regenerates docs/wpt-compliance.md with new names, pinned URLs, fixed constructor link
  • just check passes (16 lint tools + 580 tests)
  • README table updated to match (new "WPT runner" column header, data file in its own column)
  • CI on this PR stays green

Rename suite titles from project-coined labels ("Data corpus",
"hasRegExpGroups semantics", etc.) to the upstream WPT runner basenames
(``urlpattern.any.js``, ``urlpattern-hasregexpgroups.any.js``, …) so a
WHATWG / WPT contributor browsing this repo can map our conformance
rows to upstream test files at a glance.

While here, surface the pinned ``WPT_REF`` SHA in the report header
(read from the corpus checkout's ``HEAD`` so it can never disagree with
what was actually tested), pin per-suite source links to that SHA, and
fix a pre-existing broken link for the constructor suite — the old
template assumed every source file lived in
``urlpattern/resources/``, which isn't true for ``.any.js`` runners
that live at ``urlpattern/<runner>.any.js``.

``SuiteResult`` gains ``runner_path`` + ``data_path`` (replacing
``source``); per-suite section now reads ``Runner: … · Data: …`` with
both URLs, or just ``Runner:`` for the constructor (cases are inline
in the runner). README's conformance table renames the "Suite" column
to "WPT runner" with the data file in its own column.
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 12, 2026
@chad-loder chad-loder merged commit b102978 into main May 12, 2026
19 checks passed
@chad-loder chad-loder deleted the docs/wpt-suite-names branch May 12, 2026 21:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant