doc: clarify the need of compiler compatible with c++20

RafaelGSS · RafaelGSS · commit d140c3713e27 · 2025-08-12T09:19:59.000-03:00
Very often someone appear in the #node-core slack channel asking for guidance on this compilation error PR-URL: #59297 Reviewed-By: Jacob Smith <jacob@frende.me> Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
diff --git 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).
