Skip to content

Commit f739cb1

Browse files
docs: document our Node.js versioning policy (electron#40416)
Co-authored-by: trop[bot] <37223003+trop[bot]@users.noreply.github.com> Co-authored-by: Shelley Vohr <shelley.vohr@gmail.com>
1 parent b2235fe commit f739cb1

1 file changed

Lines changed: 32 additions & 6 deletions

File tree

docs/tutorial/electron-timelines.md

Lines changed: 32 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -49,12 +49,6 @@ check out our [Electron Versioning](./electron-versioning.md) doc.
4949
* Since Electron 6, Electron major versions have been targeting every other Chromium major version. Each Electron stable should happen on the same day as Chrome stable ([see blog post](https://www.electronjs.org/blog/12-week-cadence)).
5050
* Since Electron 16, Electron has been releasing major versions on an 8-week cadence in accordance to Chrome's change to a 4-week release cadence ([see blog post](https://www.electronjs.org/blog/8-week-cadence)).
5151

52-
:::info Chrome release dates
53-
54-
Chromium has the own public release schedule [here](https://chromiumdash.appspot.com/schedule).
55-
56-
:::
57-
5852
## Version support policy
5953

6054
:::info
@@ -79,6 +73,38 @@ and the version prior to that receives the vast majority of those fixes
7973
as time and bandwidth warrants. The oldest supported release line will receive
8074
only security fixes directly.
8175

76+
### Chromium version support
77+
78+
:::info Chromium release schedule
79+
80+
Chromium's public release schedule is [here](https://chromiumdash.appspot.com/schedule).
81+
82+
:::
83+
84+
Electron targets Chromium even-number versions, releasing every 8 weeks in concert
85+
with Chromium's 4-week release schedule. For example, Electron 26 uses Chromium 116, while Electron 27 uses Chromium 118.
86+
87+
### Node.js version support
88+
89+
Electron upgrades its `main` branch to even-number versions of Node.js when they enter Active LTS. The schedule
90+
is as follows:
91+
92+
<img src="https://raw.githubusercontent.com/nodejs/Release/main/schedule.svg?sanitize=true" alt="Releases">
93+
94+
As a rule, stable branches of Electron do not receive Node.js upgrades after they have been cut.
95+
If Electron has recently updated its `main` branch to a new major version of Node.js, the next stable
96+
branch to be cut will be released with the new version.
97+
98+
Patch upgrades of Node that contain significant security or bug fixes, and are submitted
99+
more than 2 weeks prior to a stable release date, will be accepted into an Electron alpha
100+
or beta release branch.
101+
102+
Minor upgrades of Node that contain significant security or bug fixes, and are submitted
103+
more than 2 weeks prior to a stable release date may be accepted into an Electron alpha or
104+
beta release branch on a case-by-case basis. These requests will be reviewed and voted on
105+
by the [Releases Working Group](https://github.com/electron/governance/tree/main/wg-releases),
106+
to ensure minimal disruption for developers who may be consuming alpha or beta releases.
107+
82108
### Breaking API changes
83109

84110
When an API is changed or removed in a way that breaks existing functionality, the

0 commit comments

Comments
 (0)