1berry/nodejs
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

doc: clearer doc-only deprecations

Browse Source 
Explicitely mention that a documentation only deprecation does not
always imply that it will be staged for deprecation in a future
Node.js major release. It is mainly there to tell developers that
a specific API should be avoided.

PR-URL: https://github.com/nodejs/node/pull/20381
Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: Tiancheng "Timothy" Gu <timothygu99@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
This commit is contained in:
Ruben Bridgewater 2018-04-28 17:22:19 +02:00
parent 974df9c2be
commit 28a54cb83a
No known key found for this signature in database
GPG Key ID: F07496B3EB3C1762
1 changed files with 9 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
COLLABORATOR_GUIDE.md
View File

@ -416,14 +416,15 @@ longer be used.
Node.js uses three Deprecation levels: Node.js uses three Deprecation levels:
* *Documentation-Only Deprecation* refers to elements of the Public API that are * *Documentation-Only Deprecation* refers to elements of the Public API that
being staged for deprecation in a future Node.js major release. An explicit should be avoided by developers and that might be staged for a runtime
notice indicating the deprecated status is added to the API documentation deprecation in a future Node.js major release. An explicit notice indicating
but no functional changes are implemented in the code. There will be no the deprecation status is added to the API documentation but no functional
runtime deprecation warnings emitted for such deprecations by default. changes are implemented in the code. By default there will be no deprecation
Documentation-only deprecations may trigger a runtime warning when Node.js warnings emitted for such deprecations at runtime. Documentation-only
is started with the [`--pending-deprecation`][] flag or the deprecations may trigger a runtime warning when Node.js is started with the
`NODE_PENDING_DEPRECATION=1` environment variable is set. [`--pending-deprecation`][] flag or the `NODE_PENDING_DEPRECATION=1`
environment variable is set.
* *Runtime Deprecation* refers to the use of process warnings emitted at * *Runtime Deprecation* refers to the use of process warnings emitted at
runtime the first time that a deprecated API is used. A command-line runtime the first time that a deprecated API is used. A command-line