doc: add blurb about implications of ABI stability
Mention that ABI stability can be achieved only by linking to ABI- stable parts of Node.js and to other libraries which are ABI-stable.

Mention that ABI stability can be achieved only by linking to ABI- stable parts of Node.js and to other libraries which are ABI-stable.
squash! add-on -> addon
nodejs · gabrielschulhof · gabrielschulhof · gabrielschulhof · Aug 24, 2018 · nodejs-github-bot
diff --git a/doc/api/n-api.md b/doc/api/n-api.md
+
+Although N-API provides an ABI stability guarantee, other parts of Node.js do
+not, and any external libraries used from the addon may not. In particular,
+neither of the following Node.js APIs provides an ABI stability guarantee:
diff --git a/doc/api/n-api.md b/doc/api/n-api.md
+    #include <node_object_wrap.h>
+    #include <node_perf_common.h>
+    #include <node_platform.h>
+    #include <node_version.h>
diff --git a/doc/api/addons.md b/doc/api/addons.md
@@ -367,6 +367,10 @@ set of APIs that are used by the native code. Instead of using the V8
 or [Native Abstractions for Node.js][] APIs, the functions available
 in the N-API are used.

+Creating and maintaining an add-on that benefits from the ABI stability
diff --git a/doc/api/n-api.md b/doc/api/n-api.md
+```C
+#include <node_api.h>
+```
+and by checking, for all external library that it uses, that the external