doc: remove deprecation definition in Collaborator Guide
The Collaborator Guide links to a definition of "deprecation" but also quotes it extensively. Remove the extensive quotes. PR-URL: https://github.com/nodejs/node/pull/26157 Reviewed-By: Gus Caplan <me@gus.host> Reviewed-By: Richard Lau <riclau@uk.ibm.com> Reviewed-By: Anto Aravinth <anto.aravinth.cse@gmail.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
This commit is contained in:
parent
c37b39282b
commit
0ebff65b65
@ -319,13 +319,7 @@ guide](https://github.com/nodejs/node/blob/master/doc/guides/adding-new-napi-api
|
|||||||
|
|
||||||
### Deprecations
|
### Deprecations
|
||||||
|
|
||||||
[_Deprecation_][] is "the discouragement of use of some … feature … or practice,
|
Node.js uses three [Deprecation][] levels:
|
||||||
typically because it has been superseded or is no longer considered efficient or
|
|
||||||
safe, without completely removing it or prohibiting its use. It can also imply
|
|
||||||
that a feature, design, or practice will be removed or discontinued entirely in
|
|
||||||
the future."
|
|
||||||
|
|
||||||
Node.js uses three Deprecation levels:
|
|
||||||
|
|
||||||
* *Documentation-Only Deprecation*: A deprecation notice is added to the API
|
* *Documentation-Only Deprecation*: A deprecation notice is added to the API
|
||||||
documentation but no functional changes are implemented in the code. By
|
documentation but no functional changes are implemented in the code. By
|
||||||
@ -795,9 +789,9 @@ When things need extra attention, are controversial, or `semver-major`:
|
|||||||
If you cannot find who to cc for a file, `git shortlog -n -s <file>` may help.
|
If you cannot find who to cc for a file, `git shortlog -n -s <file>` may help.
|
||||||
|
|
||||||
["Merge Pull Request"]: https://help.github.com/articles/merging-a-pull-request/#merging-a-pull-request-on-github
|
["Merge Pull Request"]: https://help.github.com/articles/merging-a-pull-request/#merging-a-pull-request-on-github
|
||||||
|
[Deprecation]: https://en.wikipedia.org/wiki/Deprecation
|
||||||
[Stability Index]: doc/api/documentation.md#stability-index
|
[Stability Index]: doc/api/documentation.md#stability-index
|
||||||
[TSC]: https://github.com/nodejs/TSC
|
[TSC]: https://github.com/nodejs/TSC
|
||||||
[_Deprecation_]: https://en.wikipedia.org/wiki/Deprecation
|
|
||||||
[`--pending-deprecation`]: doc/api/cli.md#--pending-deprecation
|
[`--pending-deprecation`]: doc/api/cli.md#--pending-deprecation
|
||||||
[`--throw-deprecation`]: doc/api/cli.md#--throw-deprecation
|
[`--throw-deprecation`]: doc/api/cli.md#--throw-deprecation
|
||||||
[`node-core-utils`]: https://github.com/nodejs/node-core-utils
|
[`node-core-utils`]: https://github.com/nodejs/node-core-utils
|
||||||
|
Loading…
x
Reference in New Issue
Block a user