From 90dea9e3e003945f113aaca09c45f963fe566a47 Mon Sep 17 00:00:00 2001
From: Jason Zhang <xzha4350@gmail.com>
Date: Thu, 8 Aug 2024 15:28:53 +0930
Subject: [PATCH] doc: warn for windows build bug

Refs: https://github.com/nodejs/build/issues/3739
PR-URL: https://github.com/nodejs/node/pull/54217
Reviewed-By: Stefan Stojanovic <stefan.stojanovic@janeasystems.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Jake Yuesong Li <jake.yuesong@gmail.com>
---
 BUILDING.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/BUILDING.md b/BUILDING.md
index 62bb0c075b95a7..c6d1fafb5de378 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -644,6 +644,8 @@ Optional requirements to build the MSI installer package:
 Optional requirements for compiling for Windows on ARM (ARM64):
 
 * Visual Studio 17.6.0 or newer
+  > **Note:** There is [a bug](https://github.com/nodejs/build/issues/3739) in `17.10.x`
+  > preventing Node.js from compiling.
 * Visual Studio optional components
   * Visual C++ compilers and libraries for ARM64
   * Visual C++ ATL for ARM64