Skip to content

Commit 66c6818

Browse files
Trotttargos
authored andcommitted
doc,meta: prefer aliases and stubs over Runtime Deprecations
Avoid Runtime Deprecations when an alias or a stub/no-op will suffice. An alias or stub will have lower maintenance costs for end users. Refs: #29989 (comment) PR-URL: #30153 Reviewed-By: Anna Henningsen <[email protected]> Reviewed-By: Michaël Zasso <[email protected]> Reviewed-By: Colin Ihrig <[email protected]> Reviewed-By: Franziska Hinkelmann <[email protected]> Reviewed-By: Trivikram Kamat <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Gireesh Punathil <[email protected]> Reviewed-By: Michael Dawson <[email protected]>
1 parent b215b16 commit 66c6818

File tree

1 file changed

+3
-0
lines changed

1 file changed

+3
-0
lines changed

COLLABORATOR_GUIDE.md

+3
Original file line numberDiff line numberDiff line change
@@ -341,6 +341,9 @@ Runtime Deprecations and End-of-Life APIs (internal or public) are breaking
341341
changes (`semver-major`). The TSC may make exceptions, deciding that one of
342342
these deprecations is not a breaking change.
343343

344+
Avoid Runtime Deprecations when an alias or a stub/no-op will suffice. An alias
345+
or stub will have lower maintenance costs for end users and Node.js core.
346+
344347
All deprecations receive a unique and immutable identifier. Documentation,
345348
warnings, and errors use the identifier when referring to the deprecation. The
346349
documentation for the deprecation identifier must always remain in the API

0 commit comments

Comments
 (0)