doc: add reference to guide for N-API additions
Add reference to guide with requirements/principles for accepting additions to N-API. PR-URL: https://github.com/nodejs/node/pull/22593 Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com>
This commit is contained in:
Родитель
ef2a0bdc2e
Коммит
0c39fa4240
|
@ -21,6 +21,7 @@
|
|||
- [When Breaking Changes Actually Break Things](#when-breaking-changes-actually-break-things)
|
||||
- [Reverting commits](#reverting-commits)
|
||||
- [Introducing New Modules](#introducing-new-modules)
|
||||
- [Additions to N-API](#additions-to-n-api)
|
||||
- [Deprecations](#deprecations)
|
||||
- [Involving the TSC](#involving-the-tsc)
|
||||
* [Landing Pull Requests](#landing-pull-requests)
|
||||
|
@ -411,6 +412,18 @@ For new modules that involve significant effort, non-trivial additions to
|
|||
Node.js or significant new capabilities, an [Enhancement Proposal][] is
|
||||
recommended but not required.
|
||||
|
||||
### Additions to N-API
|
||||
|
||||
N-API provides an ABI stable API that we will have to support in future
|
||||
versions without the usual option to modify or remove existing APIs on
|
||||
SemVer boundaries. Therefore, additions need to be managed carefully.
|
||||
|
||||
This
|
||||
[guide](https://github.com/nodejs/node/blob/master/doc/guides/adding-new-napi-api.md)
|
||||
outlines the requirements and principles that we should follow when
|
||||
approving and landing new N-API APIs (any additions to `node_api.h` and
|
||||
`node_api_types.h`).
|
||||
|
||||
### Deprecations
|
||||
|
||||
[_Deprecation_][] is "the discouragement of use of some … feature … or practice,
|
||||
|
|
Загрузка…
Ссылка в новой задаче