diff --git a/files/en-us/glossary/baseline/compatibility/index.md b/files/en-us/glossary/baseline/compatibility/index.md index 215edce3a40027a..4b4c72f9e88d453 100644 --- a/files/en-us/glossary/baseline/compatibility/index.md +++ b/files/en-us/glossary/baseline/compatibility/index.md @@ -6,34 +6,9 @@ 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. +**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. -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 considers support in the following browsers: - Apple Safari (iOS) - Apple Safari (macOS) @@ -43,23 +18,25 @@ Baseline tracks availability with the following browsers: - Mozilla Firefox (Android) - Mozilla Firefox (desktop) -## Extra considerations +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: -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. +- 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 may not tell you whether a feature works with: +## Baseline badges -- 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 +![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 support in each of the Baseline browsers for at least 2.5 years. -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/). +![Blue widget with the checkmark: Baseline 2022, newly available. Four browsers' logos, all with checkmarks.](limited.png) -## Contributing +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) -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 @@ -67,3 +44,5 @@ If you have questions, feedback, or want to help update and expand the features - [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/)