Skip to content
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

Jump to bottom

#26912 Glossary: Baseline #34385

Merged
merged 6 commits into from
Jul 12, 2024
Merged

#26912 Glossary: Baseline #34385

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
89f95b6
Draft: Glossary: Baseline
estelle Jun 24, 2024
0c9f81a
Update files/en-us/glossary/baseline/compatibility/index.md
estelle Jul 4, 2024
0fa047e
Update files/en-us/glossary/baseline/compatibility/index.md
estelle Jul 4, 2024
fc4f6b3
Update files/en-us/glossary/baseline/compatibility/index.md
estelle Jul 4, 2024
7183a80
Update files/en-us/glossary/baseline/compatibility/index.md
estelle Jul 4, 2024
838cdaf
resources in see also
estelle Jul 4, 2024
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
55 changes: 17 additions & 38 deletions files/en-us/glossary/baseline/compatibility/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand All @@ -43,27 +18,31 @@ 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/).
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't have a direct suggestion here, except to say that acknowledging that Baseline is not the only source of information on this stuff, particularly on the non-browser accessibility support, was essential to previous edits to this page.

![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

- [Cross browser testing](/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing)
- [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/)