web-platform-tests / web-platform-tests/rfcs
Metadata locations
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 110
- Forks
- 90
- PR merge metrics
- No merged PRs in 30d
Description
We currently have three different sets of metadata:
- The
META.ymlfiles in web-platform-tests/wpt, which contain directory-level metadata, with two keys:spec(a URL) andsuggested_reviewers(a sequence of GitHub usernames). - The
WEB_FEATURE.ymlfiles in web-platform-tests/wpt, which map tests in a directory to Web Features. - The
META.ymlfiles in web-platform-tests/wpt-metadata, which:- Map tests in a directory to labels,
- Map tests in a directory, or subtests within a test in a directory, to (potentially "product" specific) URLs, intended to link to bugs.
This feels like we have entirely too many locations for metadata, and there's been enough times when people haven't realised that there is metadata for something somewhere, just in a different place. And least to me, it isn't clear what benefit we gain from this current duplication.
At first glance, "spec" and "web feature" seem kinda similar, and "web feature" and "label" seem kinda similar.
The Web Features RFC cites these meeting notes for the decision to put them in a separate file to the pre-existing META.yml, but it's not obvious why that decision was made.
When it comes to the wpt-metadata data, the labelling data often ends up having to have paired WPT PRs when test changes are made to Interop tests; though keeping the product-specific data out of the main repo seems sensible, even if it is still tied to the main repo's revision.
I don't know if there's appetite to try and merge some of these files, but maybe we should consider it for the sake of discoverability?
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Compare the META.yml and WEB_FEATURE.yml files in web-platform-tests/wpt with the META.yml files in web-platform-tests/wpt-metadata. Read the Web Features RFC and the linked 2023-08-01 meeting notes first. Done means a documented, agreed decision on whether the metadata locations should remain separate or be consolidated, including the rationale.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- yaml
- Domain
- tooling
- Issue type
- Refactor
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100