From cf750116762ebf647ed0e9d495de18a6ed9be3d8 Mon Sep 17 00:00:00 2001 From: "Queen Vinyl Da.i'gyu-Kazotetsu" Date: Wed, 15 Jun 2022 10:24:56 -0700 Subject: [PATCH] Tighten irrelevant flag data removal guidelines (#16637) --- docs/data-guidelines.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/data-guidelines.md b/docs/data-guidelines.md index bc4961b2e953c9..c8b33d46019a49 100644 --- a/docs/data-guidelines.md +++ b/docs/data-guidelines.md @@ -231,14 +231,15 @@ This guideline was proposed in [#6018](https://github.com/mdn/browser-compat-dat ## Removal of irrelevant flag data -Valid support statements containing flags can be removed from BCD if it is considered irrelevant. To be considered irrelevant, the support statement must meet these conditions: +Flag data is helpful for developers who may wish to test features before they are included in a stable release. However, once a feature has landed in a stable browser release, the flag data quickly becomes irrelevant and may be removed from BCD. To be considered irrelevant, the flag support statement must meet these conditions: -- As of at least two years ago, the browser has supported the feature by default or removed the flagged feature. -- The removal of the support statement must not create an ambiguous gap or void in the data for that browser (for example, leaving behind only a `"version_added": true` or `null` value). +- The browser has supported the feature by default. +- The feature can no longer be enabled by toggling the flag. +- The flag has been removed from the browser. These conditions represent minimum requirements for the removal of valid flag data; other considerations may result in flag data continuing to be relevant, even after the guideline conditions are met. -This guideline was proposed in [#6670](https://github.com/mdn/browser-compat-data/pull/6670). +This guideline was proposed in [#6670](https://github.com/mdn/browser-compat-data/pull/6670) and revised in [#16637](https://github.com/mdn/browser-compat-data/pull/16637). ## When to add `version_removed` to flagged support