Skip to content

Commit

Permalink
Revise the Baseline glossary entry to reflect the new definition (mdn…
Browse files Browse the repository at this point in the history
…#30769)

* Revise the Baseline glossary entry to reflect the new definition

* Apply linter suggestions

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
  • Loading branch information
ddbeck and github-actions[bot] authored Dec 5, 2023
1 parent ceba940 commit 234df54
Showing 1 changed file with 27 additions and 8 deletions.
35 changes: 27 additions & 8 deletions files/en-us/glossary/baseline/compatibility/index.md
Original file line number Diff line number Diff line change
@@ -6,25 +6,44 @@ page-type: glossary-definition

{{GlossarySidebar}}

**Baseline** identifies widely-supported web platform features.
Web developers can expect Baseline features to work in contemporary browsers.
**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 - is known to work consistently in at least one version before the current version of all of several well-known browsers (Chrome, Edge, Firefox, and Safari).
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

<!-- TODO: Show Baseline indicator itself, once it has been merged -->
<!-- TODO: Show Baseline iconography, once it has been merged. -->

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.
A widely available feature has been in multiple browsers for years.
It works with many browsers and devices, even ones that aren't yet up to date with the latest browser releases.

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.

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.

🟢 If you see the green Baseline badge, then you can trust that the feature will work in the browsers' latest and previous major releases.
## Browser set

<!-- TODO: Show the non-Baseline indicator itself, once it has been merged -->
Baseline tracks availability with the following browsers:

🟡 If you see a yellow badge showing that a feature is not yet Baseline, then do more research and testing with your site's users before relying on that feature, or wait for it to become Baseline.
- Apple Safari (iOS)
- Apple Safari (macOS)
- Google Chrome (Android)
- Google Chrome (desktop)
- Microsoft Edge (desktop)
- Mozilla Firefox (Android)
- Mozilla Firefox (desktop)

## Extra considerations

Baseline is a summary guide to support and doesn't cover every situation.
If your site needs to work with a browser's long-term support release, an older device or browser release, or a browser not covered by the Baseline report, then you may need to do your own research or testing.
If your site needs to work with an older device or browser release, or a browser not covered by the Baseline status, then you may need to do your own research or testing.
If Baseline doesn't cover your situation, then consider reading browser compatibility tables on MDN or visiting [caniuse.com](https://caniuse.com/) before committing to a feature.

## Contributing

0 comments on commit 234df54

Please sign in to comment.