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

Update the browser support policy page #1088

Merged
merged 7 commits into from
May 9, 2024
Merged

Update the browser support policy page #1088

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
c5a0c1c
Amend the browser support policy for Safari, per: https://github.com/…
NullVoxPopuli Feb 23, 2024
cbb049d
Update browser-support.hbs
NullVoxPopuli Mar 6, 2024
eefa8cc
Update browser-support.hbs
achambers Apr 17, 2024
736a9bd
fix lint issues for < and >
mansona May 3, 2024
9f30661
Updates with Chris
NullVoxPopuli May 8, 2024
47afdf1
Update browser-support.hbs
NullVoxPopuli May 8, 2024
b84f392
ranges
NullVoxPopuli May 8, 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
187 changes: 61 additions & 126 deletions app/templates/browser-support.hbs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,64 @@
<section aria-labelledby="section-browser-support-policy">
<h1 id="section-browser-support-policy">Ember.js Browser Support Policy</h1>

<h2>Ember 5.0.0</h2>
<p>
For evergreen browsers, the minimum version of the browser that we support can be
determined at the time of every minor release, following this formula:
</p>

<div class="layout my-3">
<div class="card">
<div class="card__content">
<p>
Whichever browser version is greater/more recent out of the following,
given that the owning entity (e.g.: Apple, Google, Mozilla) still supports the version
</p>

<ol>
<li>
The lowest/least recent version that fulfills any one of these properties:
<ul>
<li>It is the latest version of the browser.</li>
<li>It is the latest LTS/extended support version of the browser (such as Firefox ESR).</li>
<li>It has at least <em>0.25%</em> of global marketshare usage across mobile and
desktop, based on <a href="https://gs.statcounter.com/">statcounter</a>.</li>
</ul>
</li>
<li>
The minimum version supported in the previous release
</li>
</ol>
</div>
</div>
</div>

<p>Supported evergreen browsers are <strong>Google Chrome</strong> and <strong>Mozilla Firefox</strong> for desktop, mobile, and testing. Additionally, <strong>Microsoft Edge</strong> is supported for desktop.</p>

<p>
In Ember 5.0.0, the framework supports the following major browsers:
Currently we support one non-evergreen browser: <strong>Apple Safari</strong> on desktop and mobile.
Support is locked at a specific major version, and
we support all major versions above that version.
</p>

<p class="mb-3">
Note: Within a major version of a browser, we only support the most recent patch release.
</p>

<EsNote @mascot='zoey'>
As of
the RFC <a href="https://rfcs.emberjs.com/id/0984-update-browser-support-policy">Treat Safari as an Evergreen Browser</a>,
at version 6.0.0 of Ember, Safari will be considered evergreen so the minimum supported Safari version will change based on the above formula.
</EsNote>

<p class="mt-3">
Other browsers may work with Ember.js, but are not explicitly supported. If you
would like to add support for a new browser, please <a href="https://github.com/emberjs/rfcs">submit an RFC for discussion</a>!
</p>

<h2>Browser Support by Major Ember Version</h2>

<h3>Ember 5.x</h3>

<ul class="list-unstyled layout my-3">
<EsCard class="lg:col-2">
<div class="text-center text-md">Desktop</div>
Expand Down Expand Up @@ -36,11 +88,7 @@
</EsCard>
</ul>

<h2>Ember 4.0.0</h2>

<p>
In Ember 4.0.0, the framework supports the following major browsers:
</p>
<h3>Ember 4.x</h3>

<ul class="list-unstyled layout my-3">
<EsCard class="lg:col-2">
Expand Down Expand Up @@ -69,138 +117,25 @@
</EsCard>
</ul>

<h2>Ember 3.0.0</h2>
<h3>Ember 3.x</h3>

<p>
Ember currently targets Internet Explorer 11 as a baseline for support. This means that generally all modern and relatively recent browsers will work with Ember, since browsers are backwards compatible by design. Ember runs tests against the latest desktop versions of the following browsers:
The first Ember major version to be covered by the <a href="https://rfcs.emberjs.com/id/0685-new-browser-support-policy">New Browser Support Policy</a> was 4.0.0. The following browser support numbers are not official and are estimated based on the CI testing matrix for the 3.x series.
</p>

<div class="layout my-3">
<div class="card lg:col-2 lg:start-3">
<div class="card__content">
<ul>
<li>Google Chrome</li>
<li>Mozilla Firefox</li>
<li>Microsoft Edge</li>
<li>Google Chrome >= 62</li>
<li>Mozilla Firefox >= 57</li>
<li>Microsoft Edge >= 14</li>
<li>Internet Explorer 11</li>
<li>Safari</li>
<li>Safari >= 8</li>
</ul>
</div>
</div>
</div>

<p>
Other browsers may work with Ember.js, but are not explicitly supported. If you
would like to add support for a new browser, please <a href="https://github.com/emberjs/rfcs">submit an RFC or RFC issue for discussion</a>!
</p>


<p>
We determine support on a browser-by-browser basis. Browsers are categorized as
either <em>evergreen</em> or <em>non-evergreen</em>. The categorization is as follows:
</p>

<h3 class="text-center">Evergreen</h3>

<ul class="list-unstyled layout my-3">
<EsCard class="lg:col-2">
<div class="text-center text-md">Desktop</div>
<ul>
<li>Google Chrome</li>
<li>Mozilla Firefox</li>
<li>Microsoft Edge</li>
</ul>
</EsCard>
<EsCard class="lg:col-2">
<div class="text-center text-md">Mobile</div>
<ul>
<li>Google Chrome</li>
<li>Mozilla Firefox</li>
</ul>
</EsCard>
<EsCard class="lg:col-2">
<div class="text-center text-md">Testing</div>
<ul>
<li>Google Chrome</li>
<li>Mozilla Firefox</li>
</ul>
</EsCard>
</ul>

<h3 class="text-center">Non-evergreen</h3>

<div class="layout">
<ul class="list-unstyled layout lg:col-4 lg:start-2 my-3">
<EsCard class="lg:col-3">
<div class="text-center text-md">Desktop</div>
<ul>
<li>Safari</li>
</ul>
</EsCard>
<EsCard class="lg:col-3">
<div class="text-center text-md">Mobile</div>
<ul>
<li>Safari</li>
</ul>
</EsCard>
</ul>
</div>

<p>
For evergreen browsers, the minimum version of the browser that we support is
determined at the time of every minor release, following this formula:
</p>

<div class="layout my-3">
<div class="card">
<div class="card__content">
<p>Whichever browser version is greater/more recent out of:</p>

<ol>
<li>
The lowest/least recent version that fulfills any one of these properties:
<ul>
<li>It is the latest version of the browser.</li>
<li>It is the latest LTS/extended support version of the browser (such as Firefox ESR).</li>
<li>It has at least <em>0.25%</em> of global marketshare usage across mobile and
desktop, based on <a href="https://gs.statcounter.com/">statcounter</a>.</li>
</ul>
</li>
<li>
The minimum version supported in the previous release
</li>
</ol>
</div>
</div>
</div>

<p>
To simplify, the supported version either moves forward or stays the same for
each release based on overall usage and LTS/current release versions.
</p>

<p>
For non-evergreen browsers, support is locked at a specific major version, and
we support all major versions above that version:
</p>

<div class="layout">
<ul class="list-unstyled layout lg:col-4 lg:start-2 my-3">
<EsCard class="lg:col-3">
<div class="text-center text-md">Desktop</div>
<ul>
<li>Safari: 12</li>
</ul>
</EsCard>
<EsCard class="lg:col-3">
<div class="text-center text-md">Mobile</div>
<ul>
<li>Safari: 12</li>
</ul>
</EsCard>
</ul>
</div>

Within a version of a browser, we only support the most recent patch release.
</section>
</div>
Loading