Skip to content

Allow overlapping compat keys#4034

Open
ddbeck wants to merge 1 commit into
web-platform-dx:mainfrom
ddbeck:overlap-compat-keys
Open

Allow overlapping compat keys#4034
ddbeck wants to merge 1 commit into
web-platform-dx:mainfrom
ddbeck:overlap-compat-keys

Conversation

@ddbeck
Copy link
Copy Markdown
Collaborator

@ddbeck ddbeck commented May 13, 2026

Towards #1173 and a prerequisite to feature merging.

This PR allows authors to allow BCD keys to be shared between features, by adding them to an allow list. It provides guidelines for when to do this (rarely) and demonstrates it by resolving one of the commented cases where we wished to do this.

This PR is not strictly breaking, but we should announce it in the upcoming changes discussion thread and emphasize this change in the release notes.

@ddbeck ddbeck added the minor version required This PR requires a minor version semver release (vX.Y+1.0) label May 13, 2026
@github-actions github-actions Bot added documentation Improvements or additions to documentation feature definition Creating or defining new features or groups of features. tools and infrastructure Project internal tooling, such as linters, GitHub Actions, or repo settings labels May 13, 2026
@ddbeck ddbeck force-pushed the overlap-compat-keys branch 4 times, most recently from 25832e1 to 55e55d1 Compare May 18, 2026 12:23
@ddbeck ddbeck force-pushed the overlap-compat-keys branch from 55e55d1 to e473578 Compare May 18, 2026 12:25
@ddbeck ddbeck added the R26:lifecycle Lifecycle management (roadmap 2026) label May 26, 2026
Comment thread docs/guidelines.md
You can add a single key to two or more `compat_features` lists when independent features share some interface and one of these situations applies:

- No feature has any claim to being first and the shared interface does not represent a useful feature on its own.
This sometimes happens when two independent features share a common interface.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think such features are very rarely independent, and more commonly are closely related:

Suggested change
This sometimes happens when two independent features share a common interface.
This sometimes happens when two features share a common interface.

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 feature definition Creating or defining new features or groups of features. minor version required This PR requires a minor version semver release (vX.Y+1.0) R26:lifecycle Lifecycle management (roadmap 2026) tools and infrastructure Project internal tooling, such as linters, GitHub Actions, or repo settings

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants