diff --git a/BUILDING.md b/BUILDING.md index 1ecdc5abb17adc..3f95f32d72d9b6 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -433,3 +433,14 @@ To make `./myCustomModule.js` available via `require('myCustomModule')`. ```console > .\vcbuild link-module './myCustomModule.js' ``` + +## Note for downstream distributors of Node.js + +The Node.js ecosystem is reliant on ABI compatibility within a major +release. To maintain ABI compatibility it is required that production +builds of Node.js will be built against the same version of dependencies as the +project vendors. If Node.js is to be built against a different version of a +dependency please create a custom `NODE_MODULE_VERSION` to ensure ecosystem +compatibility. Please consult with the TSC by opening an issue at +https://github.com/nodejs/tsc/issues if you decide to create a custom +`NODE_MODULE_VERSION` so we can avoid duplication in the ecosystem.