From 310614996588d3c914c8d1197460d458022adc42 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 4210faa737a141..d02c51f4c276ae 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -651,6 +651,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