From 47c1e9175198cd52316caf872ff741f6c665f7fa Mon Sep 17 00:00:00 2001
From: Mike McCready <66998419+MikeMcC399@users.noreply.github.com>
Date: Tue, 19 May 2026 12:20:20 +0200
Subject: [PATCH 1/2] doc: add Rust toolchain general install instructions

Signed-off-by: Mike McCready <66998419+MikeMcC399@users.noreply.github.com>
---
 BUILDING.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/BUILDING.md b/BUILDING.md
index 5cf5e9f57d6753..ca114ff08f3f4f 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -237,10 +237,23 @@ tarball and/or browse the git repository checked out at the relevant tag.
 ### Prerequisites
 
 * [A supported version of Python][Python versions] for building and testing.
+* A Rust toolchain according to [Building Node.js with Temporal support](#building-nodejs-with-temporal-support)
 * Memory: at least 8GB of RAM is typically required when compiling with 4 parallel jobs (e.g: `make -j4`)
 
 ### Unix and macOS
 
+Developers should use the official [Install Rust](https://rust-lang.org/tools/install/)
+instructions to install a Rust toolchain, required for Temporal support introduced in Node.js 26.
+
+Individual packages such as `rust` and `cargo` in some operating system distributions may be considered
+as an alternative for CI environments.
+Consult with relevant operating system documentation to ensure that packages
+meet the minimum version specified in
+[Building Node.js with Temporal support](#building-nodejs-with-temporal-support),
+as packaged versions may lag behind the `stable` version installed by the official instructions.
+Avoid mixing `rustup` together with `rust` and `cargo` package installations, due to
+potential version conflicts.
+
 #### Unix prerequisites
 
 * `gcc` and `g++` >= 13.2 or `clang` and `clang++` >= 19.1
@@ -1055,6 +1068,8 @@ requires a Rust toolchain:
 * rustc >= 1.82 (with LLVM >= 19)
 * cargo >= 1.82
 
+Refer to [Install Rust](https://rust-lang.org/tools/install/) for instructions.
+
 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.

From 6e94d65704392f2c88339c1a9ae37a13f312933b Mon Sep 17 00:00:00 2001
From: Mike McCready <66998419+MikeMcC399@users.noreply.github.com>
Date: Tue, 19 May 2026 16:29:03 +0200
Subject: [PATCH 2/2] add comment that Temporal support is enabled by default

---
 BUILDING.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/BUILDING.md b/BUILDING.md
index ca114ff08f3f4f..0f775be6120534 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -237,7 +237,8 @@ tarball and/or browse the git repository checked out at the relevant tag.
 ### Prerequisites
 
 * [A supported version of Python][Python versions] for building and testing.
-* A Rust toolchain according to [Building Node.js with Temporal support](#building-nodejs-with-temporal-support)
+* A Rust toolchain if [Building Node.js with Temporal support](#building-nodejs-with-temporal-support)
+  is required (enabled by default starting in Node.js 26)
 * Memory: at least 8GB of RAM is typically required when compiling with 4 parallel jobs (e.g: `make -j4`)
 
 ### Unix and macOS