From 89f95b622deca1255de543f6f33188b71d9493be Mon Sep 17 00:00:00 2001 From: Estelle Weyl Date: Mon, 24 Jun 2024 11:52:21 -0700 Subject: [PATCH 1/6] Draft: Glossary: Baseline --- .../glossary/baseline/compatibility/index.md | 49 ++++--------------- 1 file changed, 10 insertions(+), 39 deletions(-) diff --git a/files/en-us/glossary/baseline/compatibility/index.md b/files/en-us/glossary/baseline/compatibility/index.md index 215edce3a40027a..6e1ed44b217fd8f 100644 --- a/files/en-us/glossary/baseline/compatibility/index.md +++ b/files/en-us/glossary/baseline/compatibility/index.md @@ -6,34 +6,7 @@ page-type: glossary-definition {{GlossarySidebar}} -**Baseline** identifies web platform features that work across browsers. -Baseline helps you decide when to use a feature by telling you when it is less likely to cause compatibility problems for your site's visitors. - -A Baseline feature - such as an API, a set of CSS properties, or a JavaScript syntax - works consistently across several well-known and widely-used desktop and mobile browsers, including Chrome, Edge, Firefox, and Safari. - -Baseline features are described as either newly available in current stable browsers or widely available with continuous support over time. - -## Badges - -![Green widget with the checkmark: Baseline, widely available. Four browsers logos, all with checkmarks.](high.png) - -If you see a **widely available** Baseline badge, then you can trust that the feature has a consistent history of support in each of the Baseline browsers for at least 2.5 years. -A widely available feature works with many browsers and devices, even ones that aren't yet up to date with the latest browser releases. - -![Blue widget with the checkmark: Baseline 2022, newly available. Four browsers' logos, all with checkmarks.](limited.png) - -If you see a **newly available** Baseline badge, then you can trust that the feature works in at least the latest stable version of each of the Baseline browsers and often more. -A newly available feature works in the latest browsers, but may not work with older browsers and devices. -Consider your site's audience carefully before using a newly available feature. - -![Grey widget with the cross: limited availability. Four browsers' logos, two with checkmarks, two with crosses.](low.png) - -If you see a **limited availability** badge, then that feature is _not_ Baseline. -Do more research and testing with your site's users before relying on that feature, or wait for it to become Baseline. - -## Browser set - -Baseline tracks availability with the following browsers: +**Baseline** identifies newer web platform features, including APIs, CSS property sets, and JavaScript syntaxes, that works consistently across popular browsers. Baseline defines newer web features as being either widely available, newly available, or having limited availability in the following browsers: - Apple Safari (iOS) - Apple Safari (macOS) @@ -43,23 +16,21 @@ Baseline tracks availability with the following browsers: - Mozilla Firefox (Android) - Mozilla Firefox (desktop) -## Extra considerations +Baseline is a summary guide to browser support, but does address feature accessibility, usability, performance, security, or other concerns. -Baseline is a summary guide to browser support to help you make decisions before committing to use a feature in your projects. -Baseline is not a substitute for testing your application for accessibility, usability, performance, security, or other concerns. +## Baseline badges -Baseline may not tell you whether a feature works with: +![Green widget with the checkmark: Baseline, widely available. Four browsers logos, all with checkmarks.](high.png) + +Features listed as **widely available** have a consistent history of browser support for at least 2.5 years. -- Older devices and browser releases -- Browsers not covered by the Baseline browser set, such as operating system web views -- Assistive technology, such as screen readers +![Blue widget with the checkmark: Baseline 2022, newly available. Four browsers' logos, all with checkmarks.](limited.png) -If Baseline doesn't cover your situation, you can find more information in the browser compatibility tables on MDN, [caniuse.com](https://caniuse.com/), and [a11ysupport.io](https://a11ysupport.io/). +Features listed as **newly available** works in all stable browser versions, but may not work with older browsers and devices. -## Contributing +![Grey widget with the cross: limited availability. Four browsers' logos, two with checkmarks, two with crosses.](low.png) -Baseline is a community effort of the W3C WebDX Community Group and relies on MDN's open source browser compatibility data. -If you have questions, feedback, or want to help update and expand the features covered by Baseline status reports, then go to [web-platform-dx/web-features](https://github.com/web-platform-dx/web-features) to participate. +Features listed with **limited availability** are _not_ yet available in all browsers. ## See also From 0c9f81af3353a10c16f415181fad3e6c765323cf Mon Sep 17 00:00:00 2001 From: Estelle Weyl Date: Thu, 4 Jul 2024 01:51:51 -0700 Subject: [PATCH 2/6] Update files/en-us/glossary/baseline/compatibility/index.md Co-authored-by: Daniel D. Beck --- files/en-us/glossary/baseline/compatibility/index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/files/en-us/glossary/baseline/compatibility/index.md b/files/en-us/glossary/baseline/compatibility/index.md index 6e1ed44b217fd8f..6f99e825aa80b28 100644 --- a/files/en-us/glossary/baseline/compatibility/index.md +++ b/files/en-us/glossary/baseline/compatibility/index.md @@ -6,7 +6,9 @@ page-type: glossary-definition {{GlossarySidebar}} -**Baseline** identifies newer web platform features, including APIs, CSS property sets, and JavaScript syntaxes, that works consistently across popular browsers. Baseline defines newer web features as being either widely available, newly available, or having limited availability in the following browsers: +**Baseline** identifies the availability of web platform features across popular browsers, including APIs, CSS properties, and JavaScript syntax. Baseline describes web features as being either widely available or newly available. Features that do not meet the Baseline criteria are said to have limited availability. + +Baseline considers support in the following browsers: - Apple Safari (iOS) - Apple Safari (macOS) From 0fa047e9d8b1a9a1ec2e557ced663c5397f17d55 Mon Sep 17 00:00:00 2001 From: Estelle Weyl Date: Thu, 4 Jul 2024 01:52:17 -0700 Subject: [PATCH 3/6] Update files/en-us/glossary/baseline/compatibility/index.md Co-authored-by: Daniel D. Beck --- files/en-us/glossary/baseline/compatibility/index.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/files/en-us/glossary/baseline/compatibility/index.md b/files/en-us/glossary/baseline/compatibility/index.md index 6f99e825aa80b28..e7d199e6e37b0f5 100644 --- a/files/en-us/glossary/baseline/compatibility/index.md +++ b/files/en-us/glossary/baseline/compatibility/index.md @@ -18,7 +18,11 @@ Baseline considers support in the following browsers: - Mozilla Firefox (Android) - Mozilla Firefox (desktop) -Baseline is a summary guide to browser support, but does address feature accessibility, usability, performance, security, or other concerns. +Baseline is a summary of browser support. It is not a substitute for accessibility, usability, performance, security, or other testing. Baseline may not tell if you if a feature works with: + +- Older devices and browser releases +- Browsers not covered by the Baseline definition, such as operating system web views +- Assistive technology, such as screen readers. ## Baseline badges From fc4f6b36d0c28cf1bb454eb9f0d1d08984c98916 Mon Sep 17 00:00:00 2001 From: Estelle Weyl Date: Thu, 4 Jul 2024 01:52:41 -0700 Subject: [PATCH 4/6] Update files/en-us/glossary/baseline/compatibility/index.md Co-authored-by: Daniel D. Beck --- files/en-us/glossary/baseline/compatibility/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/glossary/baseline/compatibility/index.md b/files/en-us/glossary/baseline/compatibility/index.md index e7d199e6e37b0f5..905f2ca84d8c622 100644 --- a/files/en-us/glossary/baseline/compatibility/index.md +++ b/files/en-us/glossary/baseline/compatibility/index.md @@ -32,7 +32,7 @@ Features listed as **widely available** have a consistent history of browser sup ![Blue widget with the checkmark: Baseline 2022, newly available. Four browsers' logos, all with checkmarks.](limited.png) -Features listed as **newly available** works in all stable browser versions, but may not work with older browsers and devices. +Features listed as **newly available** work in at least the latest stable version of each of the Baseline browsers, but may not work with older browsers and devices. ![Grey widget with the cross: limited availability. Four browsers' logos, two with checkmarks, two with crosses.](low.png) From 7183a8095da9c10210793510372f9bd4b7150c87 Mon Sep 17 00:00:00 2001 From: Estelle Weyl Date: Thu, 4 Jul 2024 01:52:55 -0700 Subject: [PATCH 5/6] Update files/en-us/glossary/baseline/compatibility/index.md Co-authored-by: Daniel D. Beck --- files/en-us/glossary/baseline/compatibility/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/glossary/baseline/compatibility/index.md b/files/en-us/glossary/baseline/compatibility/index.md index 905f2ca84d8c622..329b932f4aa96bb 100644 --- a/files/en-us/glossary/baseline/compatibility/index.md +++ b/files/en-us/glossary/baseline/compatibility/index.md @@ -28,7 +28,7 @@ Baseline is a summary of browser support. It is not a substitute for accessibili ![Green widget with the checkmark: Baseline, widely available. Four browsers logos, all with checkmarks.](high.png) -Features listed as **widely available** have a consistent history of browser support for at least 2.5 years. +Features listed as **widely available** have a consistent history of support in each of the Baseline browsers for at least 2.5 years. ![Blue widget with the checkmark: Baseline 2022, newly available. Four browsers' logos, all with checkmarks.](limited.png) From 838cdafe244f15e8891701565201cc86f35bc08f Mon Sep 17 00:00:00 2001 From: Estelle Weyl Date: Thu, 4 Jul 2024 01:55:30 -0700 Subject: [PATCH 6/6] resources in see also --- files/en-us/glossary/baseline/compatibility/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/files/en-us/glossary/baseline/compatibility/index.md b/files/en-us/glossary/baseline/compatibility/index.md index 329b932f4aa96bb..4b4c72f9e88d453 100644 --- a/files/en-us/glossary/baseline/compatibility/index.md +++ b/files/en-us/glossary/baseline/compatibility/index.md @@ -44,3 +44,5 @@ Features listed with **limited availability** are _not_ yet available in all bro - [web-platform-dx/web-features repository](https://github.com/web-platform-dx/web-features) - [W3C WebDX Community Group](https://www.w3.org/community/webdx/) - [mdn/browser-compat-data repository](https://github.com/mdn/browser-compat-data) +- [caniuse.com](https://caniuse.com/) +- [a11ysupport.io](https://a11ysupport.io/)