From 21df27c1e559c534b625871ace83ddf7a5b64cc4 Mon Sep 17 00:00:00 2001
From: Joyee Cheung <joyeec9h3@gmail.com>
Date: Thu, 18 Dec 2025 13:23:26 +0100
Subject: [PATCH] doc: add a tip about developer mode on Windows

On Windows, creating symlinks requires Developer Mode to be
enabled or running the command as Administrator. Tests that
rely on creating symlinks may fail with EPERM errors if
symlink creation is not permitted. Add a tip about this
for the docs about running tests on Windows.
---
 BUILDING.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/BUILDING.md b/BUILDING.md
index 7a11dd65a7fc82..e4963efb7abe15 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -870,6 +870,11 @@ To test if Node.js was built correctly:
 Release\node -e "console.log('Hello from Node.js', process.version)"
 ```
 
+> \[!TIP]
+> On Windows, creating symlinks requires [Developer Mode][] to be enabled or
+> running the command as Administrator. Tests that rely on creating symlinks
+> may fail with EPERM errors if symlink creation is not permitted.
+
 ##### Using ccache:
 
 Follow <https://github.com/ccache/ccache/wiki/MS-Visual-Studio>, and you
@@ -1140,4 +1145,5 @@ by opening a pull request against the registry available at
 <https://github.com/nodejs/node/blob/HEAD/doc/abi_version_registry.json>.
 
 [AIX toolbox]: https://www.ibm.com/support/pages/aix-toolbox-open-source-software-overview
+[Developer Mode]: https://learn.microsoft.com/en-us/windows/advanced-settings/developer-mode
 [Python versions]: https://devguide.python.org/versions/