diff --git a/doc/contributing/collaborator-guide.md b/doc/contributing/collaborator-guide.md index c0777771be631e..b81a86bd86c08f 100644 --- a/doc/contributing/collaborator-guide.md +++ b/doc/contributing/collaborator-guide.md @@ -443,10 +443,12 @@ metadata. Raise a pull request like any other change. Treat commits that introduce new core modules with extra care. -New modules must only be added with the `node:` prefix. +New modules must only be added with the `node:` prefix, as `semver-minor`. -When adding promises to an existing API, add `/promises` -(`inspector/promises`, etc.). Apply the `semver-major` label to the addition. +When adding a "sub-module", e.g. a promise variant of an existing API (e.g. +`node:inspector/promises`) that is available without the `node:` prefix, making +the sub-module available without the prefix is possible behind a runtime flag, +or as a `semver-major` change. If the new module name is free in npm, register a placeholder in the module registry as soon as possible. Link to the pull