Commit d7eaf3a
doc: revise N-API versions matrix text
Revise text for clarity, brevity, and conformance with our style guide.
PR-URL: #34566
Reviewed-By: Gus Caplan <me@gus.host>
Reviewed-By: Michael Dawson <michael_dawson@ca.ibm.com>
Reviewed-By: Richard Lau <riclau@uk.ibm.com>
Reviewed-By: James M Snell <jasnell@gmail.com>1 parent 36fd3da commit d7eaf3a
1 file changed
Lines changed: 4 additions & 6 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -251,13 +251,11 @@ listed as supporting a later version. | |||
| 251 | 251 | | v13.x | v13.0.0 | v13.0.0 | v13.0.0 | v13.0.0 | v13.0.0 | | | |
| 252 | 252 | | v14.x | v14.0.0 | v14.0.0 | v14.0.0 | v14.0.0 | v14.0.0 | v14.0.0 | | |
| 253 | 253 | ||
| 254 | - \* Indicates that the N-API version was released as experimental | ||
| 254 | + \* N-API was experimental. | ||
| 255 | 255 | ||
| 256 | - \*\* First version which matches version 1 in later releases. While v8.0.0 | ||
| 257 | - included N-API as experimental, version 1 continued to evolve until | ||
| 258 | - v8.6.0 and therefore the shape of the API in earlier versions is not | ||
| 259 | - truly version 1 (in hindsight we should have called it version 0). | ||
| 260 | - We recommend version 3 or later. | ||
| 256 | + \*\* Node.js 8.0.0 included N-API as experimental. It was released as N-API | ||
| 257 | + version 1 but continued to evolve until Node.js 8.6.0. The API is different in | ||
| 258 | + versions prior to Node.js 8.6.0. We recommend N-API version 3 or later. | ||
| 261 | 259 | ||
| 262 | 260 | The N-APIs associated strictly with accessing ECMAScript features from native | |
| 263 | 261 | code can be found separately in `js_native_api.h` and `js_native_api_types.h`. | |
0 commit comments