Skip to content

Add guidelines for moving and splitting features #3180

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

ddbeck
Copy link
Collaborator

@ddbeck ddbeck commented Jul 24, 2025

Towards #91 and the sequel to #3000.

This PR adds guidelines for redirecting features: moving a feature from one ID or splitting it into multiple other IDs. This is written with the assumption that we'll adopt the schema given in #3000, but the overall gist of it should be the same for any reasonable schema definition.

@ddbeck ddbeck added this to the web-features v3.0 milestone Jul 24, 2025
@ddbeck ddbeck added documentation Improvements or additions to documentation major version required This PR requires a minor version semver release (vX+1.0.0) package:web-features feature evolution Issues/PRs for describing changing feature definitions over time (as opposed to support) labels Jul 24, 2025
* The original feature ID is misspelled.
* The original feature ID breaks the identifier guidelines.
* Data consumers report that the original feature ID is confusing or misleading.
* The original feature should not have existed as an independent feature.
Copy link
Contributor

Choose a reason for hiding this comment

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

We should add some examples of how to identify cases when this applies.

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 evolution Issues/PRs for describing changing feature definitions over time (as opposed to support) major version required This PR requires a minor version semver release (vX+1.0.0) package:web-features
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants