Mark features with one engine support 'experimental' #17391

OnkarRuikar · 2022-08-16T04:48:23Z

Similar to #17357

Summary

These features are supported by only one engine, so should be marked as 'experimental'.

Supporting details

mdn/content#19569 (review)

cc/ @teoli2003

teoli2003

This looks ok to me. As there will be others PRs like this, I would like a second check on the first one.

@OnkarRuikar told me there are about 130 errors in mdn/browser-compat-data.

teoli2003 · 2022-08-16T05:46:44Z

(Note we are synchronizing, with a script, what is displayed on MDN and what is in bcd. One day it will be displayed automatically but we had 100s of errors so it was really needed).

queengooborg · 2022-08-16T08:57:46Z

On the BCD side, we typically say that a feature that has been in one browser for a long period of time should be considered non-experimental, but what do you guys think about that?

OnkarRuikar · 2022-08-16T13:18:46Z

I used dialed down version the test-status.ts#checkExperimental() to find these. If we consider flags, prefixes, and alternative names then there will be ~316 files modified in the entire repo.

On top of what @queengooborg said, the yarn fix is non functional at the moment, so this "one engine = experimental" is not being enforced strictly. If we mark the old features experimental then people may come complaining.

@queengooborg
What about features that are old but still behind flags?
For example:

https://developer.mozilla.org/en-US/docs/Web/API/AmbientLightSensor
https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/commit
There are ~9 such cases.

What about features that are old but still behind prefixes?
For example:

https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognition
There are ~11 such cases.

What about same for alternate names?
For example:

https://developer.mozilla.org/en-US/docs/Web/API/FetchEvent/replacesClientId
There are ~10 such cases.

queengooborg · 2022-08-16T13:22:13Z

I used dialed down version the test-status.ts#checkExperimental() to find these. If we consider flags, prefixes, and alternative names then there will be ~316 files modified in the entire repo.

The function isn't a fully-developed function to decide experimental status -- it's actually only used to set experimental to false, but not to true. My goal is to automate both experimental and standard track status, so that contributors do not have to manually update them!

We have the full breakdown of when to set experimental to true or false in the data guidelines here: https://github.com/mdn/browser-compat-data/blob/main/docs/data-guidelines.md#choosing-an-experimental-status

OnkarRuikar · 2022-08-16T13:51:50Z

The function isn't a fully-developed function to decide experimental status -- it's actually only used to set experimental to false, but not to true. My goal is to automate both experimental and standard track status, so that contributors do not have to manually update them!

I think we'll have to involve git history in the script. 🤔

We have the full breakdown of when to set experimental to true or false in the data guidelines here...

If you guys terminate this PR, I'll update the statuses on mdn/content side.
For the special cases mentioned above I've created following PRs:

teoli2003 · 2022-08-17T04:56:41Z

On the BCD side, we typically say that a feature that has been in one browser for a long period of time should be considered non-experimental, but what do you guys think about that?

I think this is a bit problematic. If a browser develops an obscure API that no other vendors is interested in, it will just sit there forever and become non-experimental.

Also, often, for APIs that are the brainchild of one vendor, the first implementation is made by the spec writers. We all know how it goes when there is some internal pressure to release: if the feature works for the purpose, management pushes for its release. When a second vendor implements it later, that's when the actual review of the API happens and where changes are implemented (if still possible). If not possible, a better API is developed and adopted by all vendors, the original API staying in one browser, deprecated, until most users have migrated (or died out).

That's why I think that not marking such APIs as experimental is detrimental to web developers. The risk of change, or event marked as deprecated, is real. When not experimental the web developer assumes that it is safe to consider it stable enough to stay forever on the Web platform. Features implemented by one vendor don't provide this guarantee.

OnkarRuikar · 2022-08-17T05:07:57Z

If not possible, a better API is developed and adopted by all vendors, the original API staying in one browser, deprecated, until most users have migrated (or died out).

…Features implemented by one vendor don't provide this guarantee.

I think the best example of this could be: https://bugs.chromium.org/p/chromium/issues/detail?id=695508#c18
Further down the conversation they suggest to use polyfill to stop using the API.

Perhaps you can use the polyfill below to get off the filesystem API?

github-actions · 2022-08-19T05:38:32Z

This pull request has merge conflicts that must be resolved before it can be merged.

github-actions · 2022-11-24T20:54:41Z

This pull request has merge conflicts that must be resolved before it can be merged.

Elchi3

Quite a lot of support data is wrong here thus leading to experimental setting. I think we should rather fix the data than set experimental.

Elchi3 · 2023-01-11T12:01:07Z

api/_globals/createImageBitmap.json

@@ -247,7 +247,7 @@
            "webview_android": "mirror"
          },
          "status": {
-            "experimental": false,


This is actually in Safari, not sure which version though.
https://github.com/WebKit/WebKit/blob/main/Source/WebCore/html/ImageBitmapOptions.idl#L37

But that makes it non-experimental.

Elchi3 · 2023-01-11T12:02:12Z

api/CSSPropertyRule.json

@@ -28,7 +28,7 @@
          "webview_android": "mirror"
        },
        "status": {
-          "experimental": false,
+          "experimental": true,


Also in Safari https://github.com/WebKit/WebKit/blob/main/Source/WebCore/css/CSSPropertyRule.idl

Elchi3 · 2023-01-11T12:03:10Z

api/CSSFontFeatureValuesRule.json

@@ -26,7 +26,7 @@
          "webview_android": "mirror"
        },
        "status": {
-          "experimental": false,


In safari actually https://github.com/WebKit/WebKit/blob/main/Source/WebCore/css/CSSFontFeatureValuesRule.idl

Elchi3 · 2023-01-11T12:06:52Z

api/BaseAudioContext.json

@@ -699,7 +699,7 @@
              "webview_android": "mirror"
            },
            "status": {
-              "experimental": false,


Supported in Firefox https://searchfox.org/mozilla-central/source/dom/webidl/PeriodicWave.webidl#14

github-actions · 2023-04-27T08:50:37Z

This pull request has merge conflicts that must be resolved before it can be merged.

Mark features with one engine support 'experimental'

7d5d1d0

github-actions bot added the data:api Compat data for Web APIs. https://developer.mozilla.org/docs/Web/API label Aug 16, 2022

teoli2003 approved these changes Aug 16, 2022

View reviewed changes

teoli2003 requested a review from queengooborg August 16, 2022 05:46

github-actions bot added the rebase needed 🚧 label Aug 19, 2022

Merge branch 'main' into are_experimental

35819af

github-actions bot removed the rebase needed 🚧 label Aug 19, 2022

OnkarRuikar mentioned this pull request Aug 24, 2022

Update BCD info, part 38 mdn/content#19910

Merged

OnkarRuikar mentioned this pull request Oct 20, 2022

OWD project: Generate "experimental" banners from BCD openwebdocs/project#81

Closed

queengooborg added not ready This is not yet ready to be merged. It's pending a decision, other PR, or a prerequisite action. meeting agenda Issues or pull requests in need of discussion in a project meeting. labels Nov 22, 2022

github-actions bot added the rebase needed 🚧 label Nov 24, 2022

Merge branch 'main' into are_experimental

332bb70

github-actions bot removed the rebase needed 🚧 label Nov 25, 2022

Elchi3 requested changes Jan 11, 2023

View reviewed changes

github-actions bot added the merge conflicts 🚧 This PR needs to merge latest "main" branch to resolve a merge conflict or other issue. label Apr 27, 2023

OnkarRuikar closed this Apr 27, 2023

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Mark features with one engine support 'experimental' #17391

Mark features with one engine support 'experimental' #17391

OnkarRuikar commented Aug 16, 2022 •

edited

Loading

teoli2003 left a comment

teoli2003 commented Aug 16, 2022

queengooborg commented Aug 16, 2022

OnkarRuikar commented Aug 16, 2022

queengooborg commented Aug 16, 2022

OnkarRuikar commented Aug 16, 2022 •

edited

Loading

teoli2003 commented Aug 17, 2022

OnkarRuikar commented Aug 17, 2022 •

edited

Loading

github-actions bot commented Aug 19, 2022

github-actions bot commented Nov 24, 2022

Elchi3 left a comment

Elchi3 Jan 11, 2023

Elchi3 Jan 11, 2023

Elchi3 Jan 11, 2023

Elchi3 Jan 11, 2023

github-actions bot commented Apr 27, 2023

Mark features with one engine support 'experimental' #17391

Mark features with one engine support 'experimental' #17391

Conversation

OnkarRuikar commented Aug 16, 2022 • edited Loading

Summary

Supporting details

teoli2003 left a comment

Choose a reason for hiding this comment

teoli2003 commented Aug 16, 2022

queengooborg commented Aug 16, 2022

OnkarRuikar commented Aug 16, 2022

queengooborg commented Aug 16, 2022

OnkarRuikar commented Aug 16, 2022 • edited Loading

teoli2003 commented Aug 17, 2022

OnkarRuikar commented Aug 17, 2022 • edited Loading

github-actions bot commented Aug 19, 2022

github-actions bot commented Nov 24, 2022

Elchi3 left a comment

Choose a reason for hiding this comment

Elchi3 Jan 11, 2023

Choose a reason for hiding this comment

Elchi3 Jan 11, 2023

Choose a reason for hiding this comment

Elchi3 Jan 11, 2023

Choose a reason for hiding this comment

Elchi3 Jan 11, 2023

Choose a reason for hiding this comment

github-actions bot commented Apr 27, 2023

OnkarRuikar commented Aug 16, 2022 •

edited

Loading

OnkarRuikar commented Aug 16, 2022 •

edited

Loading

OnkarRuikar commented Aug 17, 2022 •

edited

Loading