From fcf235d623bfe33d3934f32ba53a04ac3b9032ae Mon Sep 17 00:00:00 2001 From: Geoffrey Booth Date: Sat, 2 Mar 2024 18:15:14 -0800 Subject: [PATCH] doc: add policy for distribution PR-URL: https://github.com/nodejs/node/pull/51918 Reviewed-By: Michael Dawson Reviewed-By: Matteo Collina Reviewed-By: Yagiz Nizipli --- doc/contributing/distribution.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 doc/contributing/distribution.md diff --git a/doc/contributing/distribution.md b/doc/contributing/distribution.md new file mode 100644 index 00000000000000..4727c03b6924e5 --- /dev/null +++ b/doc/contributing/distribution.md @@ -0,0 +1,27 @@ +# Node.js Distribution Policy + +This document describes some policies around what is and is not included in the +Node.js distribution. + +## Inclusion + +The Node.js distribution includes some external software that the Node.js +project does not maintain. The choice to include a particular piece of software +should not imply anything about that software relative to its competitors; in +some cases, software was added when it had no competitors. While the Node.js +project supports and encourages competition in the JavaScript ecosystem, as a +policy, the Node.js project does not include multiple dependencies or tools that +serve the same purpose. + +The following user-accessible external tools or libraries are the ones chosen +for their particular purposes: + +* JavaScript engine: V8 +* Package manager: `npm` +* Package manager version manager: Corepack + +Being user-accessible, removal or replacement of these projects could happen +only as a semver-major change, unless the related feature or project is +documented as experimental. In addition, Node.js includes external projects as +internal dependencies. These may be replaced or removed at any time, provided +that doing so is not a breaking change.