From a345bf6c357125529446a909c47171e4afa65864 Mon Sep 17 00:00:00 2001
From: RafaelGSS <rafael.nunu@hotmail.com>
Date: Thu, 31 Jul 2025 09:31:51 -0300
Subject: [PATCH] doc: clarify the need of compiler compatible with c++20

Very often someone appear in the #node-core slack
channel asking for guidance on this compilation error
---
 BUILDING.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/BUILDING.md b/BUILDING.md
index 4c46468139f7da..3e28e3349950d2 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -272,6 +272,11 @@ export CXX=g++-12
 make -j4
 ```
 
+> \[!IMPORTANT]
+> If you face a compilation error during this process such as
+> `error: no matching conversion for functional-style cast from 'unsigned int' to 'TypeIndex'`
+> Make sure to use a `g++` or `clang` version compatible with C++20.
+
 We can speed up the builds by using [Ninja](https://ninja-build.org/). For more
 information, see
 [Building Node.js with Ninja](doc/contributing/building-node-with-ninja.md).