Skip to content

Mark the experimental property as deprecated #28811

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.

Sign up for GitHub

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

Open
ddbeck wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Mark the experimental property as deprecated #28811

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
84f5bde
Mark the `experimental` property as deprecated
ddbeck Jan 13, 2026
e9280a6
Use better brackets from @caugner
ddbeck Jan 13, 2026
481903e
Show deprecation inline from @caugner
ddbeck Jan 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion schemas/compat-data-schema.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Copy link
Contributor

@caugner caugner Jan 13, 2026

Choose a reason for hiding this comment

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

Suggested change
**Warning**: The `experimental` property is deprecated. Prefer using more well-defined stability calculations, such as Baseline, instead.
> [!WARNING]
> The `experimental` property is **deprecated**.
> Prefer using better defined stability calculations, such as Baseline, instead.

Copy link
Contributor Author

@ddbeck ddbeck Jan 13, 2026

Choose a reason for hiding this comment

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

Unfortunately, this won't work. GitHub's (non-standard, unspecified 🙄) admonitions don't work in a list. They only render if the > is at column 1.


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.

Expand Down
3 changes: 2 additions & 1 deletion schemas/compat-data.schema.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down