diff --git a/schemas/compat-data-schema.md b/schemas/compat-data-schema.md index 0efeeabbbe0928..26f006b3b087ea 100644 --- a/schemas/compat-data-schema.md +++ b/schemas/compat-data-schema.md @@ -477,7 +477,9 @@ A `boolean` value indicating whether or not the implementation of the sub-featur The mandatory status property contains information about stability of the feature. It is an object named `status` and has three mandatory properties: -- `experimental`: a `boolean` value. +- `experimental` (DEPRECATED): a `boolean` value. + + **Warning**: The `experimental` property is deprecated. Prefer using more well-defined stability calculations, such as Baseline, instead. If `experimental` is `true`, it means the feature was implemented in only one browser engine and was implemented recently. It also means that Web developers _should not_ rely on the feature's continued existence in its current (or potentially any) form in future browser releases. diff --git a/schemas/compat-data.schema.json b/schemas/compat-data.schema.json index 7430fca7f23f88..f36278c7c6e8c1 100644 --- a/schemas/compat-data.schema.json +++ b/schemas/compat-data.schema.json @@ -140,7 +140,8 @@ "properties": { "experimental": { "type": "boolean", - "description": "A boolean value that indicates the general stability of this feature. This value will be true if the feature was implemented in one browser engine recently. This value will be false if the feature was implemented in multiple browser engines, or if the feature had been implemented over two years ago in any one browser engine." + "deprecated": true, + "description": "(This property is deprecated. Prefer using more well-defined stability calculations, such as Baseline, instead.) A boolean value that hints at the general stability of this feature. This value will be true if the feature was implemented in one browser engine recently. This value will be false if the feature was implemented in multiple browser engines, or if the feature had been implemented over two years ago in any one browser engine." }, "standard_track": { "type": "boolean",