2026-05-20, Version 26.2.0 (Current)

.github/workflows/tools.yml

@@ -336,7 +336,7 @@ jobs:
         # no-op if the base branch is already up-to-date.
         with:
           token: ${{ secrets.GH_USER_TOKEN }}
-          branch: actions/tools-update-${{ matrix.id }}  # Custom branch *just* for this Action.
+          branch: actions/${{ github.ref_name == 'main' || format('{0}/', github.ref_name) }}tools-update-${{ matrix.id }}  # Custom branch *just* for this Action.
           delete-branch: true
           commit-message: ${{ env.COMMIT_MSG }}
           labels: ${{ matrix.label }}

.gitignore

@@ -160,6 +160,10 @@ cmake_install.cmake
 install_manifest.txt
 *.cbp
 
+# === Rules for AI assistants ===
+CLAUDE.md
+AGENTS.md
+
 # === Global Rules ===
 # Keep last to avoid being excluded
 *.pyc

BUILDING.md

@@ -98,7 +98,7 @@ and libc version. The table below lists the support tier for each supported
 combination. A list of [supported compile toolchains](#supported-toolchains) is
 also supplied for tier 1 platforms.
 
-**For production applications, run Node.js on supported platforms only.**
+**For production applications, run Node.js on supported platforms only (Tier 1 or 2).**
 
 Node.js does not support a platform version if a vendor has expired support
 for it. In other words, Node.js does not support running on End-of-Life (EoL)
@@ -226,12 +226,11 @@ If compiling without one of the above, use `configure` with the
 ### Previous versions of this document
 
 Supported platforms and toolchains change with each major version of Node.js.
-This document is only valid for the current major version of Node.js.
-Consult previous versions of this document for older versions of Node.js:
+This document is only valid for the current version of Node.js, and is expected
+to be valid for the entire lifetime of this release line.
 
-* [Node.js 24](https://github.com/nodejs/node/blob/v24.x/BUILDING.md)
-* [Node.js 22](https://github.com/nodejs/node/blob/v22.x/BUILDING.md)
-* [Node.js 20](https://github.com/nodejs/node/blob/v20.x/BUILDING.md)
+To consult the version of this document for another version, download its source
+tarball and/or browse the git repository checked out at the relevant tag.
 
 ## Building Node.js on supported platforms
 
@@ -753,9 +752,13 @@ Refs:
   To install it, select the following two optional components:
   * C++ Clang Compiler for Windows (Microsoft.VisualStudio.Component.VC.Llvm.Clang)
   * MSBuild support for LLVM (clang-cl) toolset (Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset)
-* As an alternative to Visual Studio 2026, download Visual Studio 2022 Current channel Version 17.4 from the
+* As an alternative to Visual Studio 2026, download Visual Studio 2022 Current channel Version 17.14 from the
   [Evergreen bootstrappers](https://learn.microsoft.com/en-us/visualstudio/releases/2022/release-history#evergreen-bootstrappers)
   table and install using the same workload and optional component selection as described above.
+* To install the Rust toolchain, required for Temporal support introduced in Node.js 26,
+  ensure Visual Studio is already installed, then run `rustup-init.exe` downloaded from
+  [Install Rust](https://rust-lang.org/tools/install/),
+  choosing the default: "Proceed with standard installation".
 * Basic Unix tools required for some tests,
   [Git for Windows](https://git-scm.com/download/win) includes Git Bash
   and tools which can be included in the global `PATH`.
@@ -1046,11 +1049,24 @@ enable FIPS support in Node.js.
 Node.js supports the [Temporal](https://github.com/tc39/proposal-temporal) APIs, when
 linking statically or dynamically with a version of [temporal\_rs](https://github.com/boa-dev/temporal).
 
-To build Node.js with Temporal support, a Rust toolchain is required:
+Temporal support is enabled by default starting in Node.js 26. Building it
+requires a Rust toolchain:
 
 * rustc >= 1.82 (with LLVM >= 19)
 * cargo >= 1.82
 
+If `--v8-enable-temporal-support` and `--v8-disable-temporal-support` are both
+omitted, `configure.py` probes for `cargo` and `rustc`. If either is missing,
+a warning is printed and Temporal support is disabled.
+
+* Pass `--v8-enable-temporal-support` to `configure.py` to require Temporal
+  support. The build will stop with an error if `cargo` or `rustc` cannot be
+  found.
+* Pass `--v8-disable-temporal-support` to opt out of Temporal support and
+  remove the Rust toolchain requirement.
+
+Passing both options to `configure.py` is an error.
+
 ## Building Node.js with external core modules
 
 It is possible to specify one or more JavaScript text files to be bundled in

CHANGELOG.md

@@ -3,12 +3,12 @@
 Select a Node.js version below to view the changelog history:
 
 * [Node.js 26](doc/changelogs/CHANGELOG_V26.md) **Current**
-* [Node.js 25](doc/changelogs/CHANGELOG_V25.md) **Current**
+* [Node.js 25](doc/changelogs/CHANGELOG_V25.md) Current
 * [Node.js 24](doc/changelogs/CHANGELOG_V24.md) **Long Term Support**
 * [Node.js 23](doc/changelogs/CHANGELOG_V23.md) End-of-Life
 * [Node.js 22](doc/changelogs/CHANGELOG_V22.md) Long Term Support
 * [Node.js 21](doc/changelogs/CHANGELOG_V21.md) End-of-Life
-* [Node.js 20](doc/changelogs/CHANGELOG_V20.md) Long Term Support
+* [Node.js 20](doc/changelogs/CHANGELOG_V20.md) End-of-Life
 * [Node.js 19](doc/changelogs/CHANGELOG_V19.md) End-of-Life
 * [Node.js 18](doc/changelogs/CHANGELOG_V18.md) End-of-Life
 * [Node.js 17](doc/changelogs/CHANGELOG_V17.md) End-of-Life
@@ -39,11 +39,11 @@ release.
   <th title="Current"><a href="doc/changelogs/CHANGELOG_V25.md">25</a> (Current)</th>
   <th title="LTS Until 2028-04"><a href="doc/changelogs/CHANGELOG_V24.md">24</a> (LTS)</th>
   <th title="LTS Until 2027-04"><a href="doc/changelogs/CHANGELOG_V22.md">22</a> (LTS)</th>
-  <th title="LTS Until 2026-04"><a href="doc/changelogs/CHANGELOG_V20.md">20</a> (LTS)</th>
 </tr>
 <tr>
   <td valign="top">
-<b><a href="doc/changelogs/CHANGELOG_V26.md#26.1.0">26.1.0</a></b><br/>
+<b><a href="doc/changelogs/CHANGELOG_V26.md#26.2.0">26.2.0</a></b><br/>
+<a href="doc/changelogs/CHANGELOG_V26.md#26.1.0">26.1.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V26.md#26.0.0">26.0.0</a><br/>
   </td>
   <td valign="top">
@@ -86,22 +86,20 @@ release.
 <a href="doc/changelogs/CHANGELOG_V24.md#24.0.0">24.0.0</a><br/>
   </td>
   <td valign="top">
-<b><a href="doc/changelogs/CHANGELOG_V23.md#23.11.0">23.11.0</a></b><br/>
-<a href="doc/changelogs/CHANGELOG_V23.md#23.10.0">23.10.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V23.md#23.9.0">23.9.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V23.md#23.8.0">23.8.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V23.md#23.7.0">23.7.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V23.md#23.6.1">23.6.1</a><br/>
-<a href="doc/changelogs/CHANGELOG_V23.md#23.6.0">23.6.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V23.md#23.5.0">23.5.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V23.md#23.4.0">23.4.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V23.md#23.3.0">23.3.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V23.md#23.2.0">23.2.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V23.md#23.1.0">23.1.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V23.md#23.0.0">23.0.0</a><br/>
-  </td>
-  <td valign="top">
-<b><a href="doc/changelogs/CHANGELOG_V22.md#22.15.0">22.15.0</a></b><br/>
+<b><a href="doc/changelogs/CHANGELOG_V22.md#22.22.3">22.22.3</a></b><br/>
+<a href="doc/changelogs/CHANGELOG_V22.md#22.22.2">22.22.2</a><br/>
+<a href="doc/changelogs/CHANGELOG_V22.md#22.22.1">22.22.1</a><br/>
+<a href="doc/changelogs/CHANGELOG_V22.md#22.22.0">22.22.0</a><br/>
+<a href="doc/changelogs/CHANGELOG_V22.md#22.21.1">22.21.1</a><br/>
+<a href="doc/changelogs/CHANGELOG_V22.md#22.21.0">22.21.0</a><br/>
+<a href="doc/changelogs/CHANGELOG_V22.md#22.20.0">22.20.0</a><br/>
+<a href="doc/changelogs/CHANGELOG_V22.md#22.19.0">22.19.0</a><br/>
+<a href="doc/changelogs/CHANGELOG_V22.md#22.18.0">22.18.0</a><br/>
+<a href="doc/changelogs/CHANGELOG_V22.md#22.17.1">22.17.1</a><br/>
+<a href="doc/changelogs/CHANGELOG_V22.md#22.17.0">22.17.0</a><br/>
+<a href="doc/changelogs/CHANGELOG_V22.md#22.16.0">22.16.0</a><br/>
+<a href="doc/changelogs/CHANGELOG_V22.md#22.15.1">22.15.1</a><br/>
+<a href="doc/changelogs/CHANGELOG_V22.md#22.15.0">22.15.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V22.md#22.14.0">22.14.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V22.md#22.13.1">22.13.1</a><br/>
 <a href="doc/changelogs/CHANGELOG_V22.md#22.13.0">22.13.0</a><br/>
@@ -121,49 +119,6 @@ release.
 <a href="doc/changelogs/CHANGELOG_V22.md#22.1.0">22.1.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V22.md#22.0.0">22.0.0</a><br/>
   </td>
-  <td valign="top">
-<b><a href="doc/changelogs/CHANGELOG_V20.md#20.20.2">20.20.2</a></b><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.20.1">20.20.1</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.20.0">20.20.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.19.6">20.19.6</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.19.5">20.19.5</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.19.4">20.19.4</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.19.3">20.19.3</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.19.2">20.19.2</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.19.1">20.19.1</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.19.0">20.19.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.18.3">20.18.3</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.18.2">20.18.2</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.18.1">20.18.1</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.18.0">20.18.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.17.0">20.17.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.16.0">20.16.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.15.1">20.15.1</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.15.0">20.15.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.14.0">20.14.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.13.1">20.13.1</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.13.0">20.13.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.12.2">20.12.2</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.12.1">20.12.1</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.12.0">20.12.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.11.1">20.11.1</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.11.0">20.11.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.10.0">20.10.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.9.0">20.9.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.8.1">20.8.1</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.8.0">20.8.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.7.0">20.7.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.6.1">20.6.1</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.6.0">20.6.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.5.1">20.5.1</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.5.0">20.5.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.4.0">20.4.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.3.1">20.3.1</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.3.0">20.3.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.2.0">20.2.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.1.0">20.1.0</a><br/>
-<a href="doc/changelogs/CHANGELOG_V20.md#20.0.0">20.0.0</a><br/>
-  </td>
 </tr>
 </table>
 

CONTRIBUTING.md

@@ -46,6 +46,7 @@ dependencies, and tools contained in the `nodejs/node` repository.
 * [Setting up your local environment](./doc/contributing/pull-requests.md#setting-up-your-local-environment)
 * [The Process of Making Changes](./doc/contributing/pull-requests.md#the-process-of-making-changes)
 * [Reviewing Pull Requests](./doc/contributing/pull-requests.md#reviewing-pull-requests)
+* [Large Pull Requests](./doc/contributing/large-pull-requests.md)
 * [Notes](./doc/contributing/pull-requests.md#notes)
 
 ## Automation and bots