doc: add ABI version registry

PR-URL: https://github.com/nodejs/node/pull/24114
Refs: https://nodejs.org/en/download/releases/
Refs: https://github.com/lgeiger/node-abi/blob/master/index.js
Refs: https://github.com/nodejs/TSC/issues/621
Reviewed-By: Michaël Zasso <targos@protonmail.com>
Reviewed-By: Ujjwal Sharma <usharma1998@gmail.com>
Reviewed-By: Michael Dawson <michael_dawson@ca.ibm.com>
Reviewed-By: Ali Ijaz Sheikh <ofrobots@google.com>

1 files changed, 9 insertions, 37 deletions

diff --git a/src/node_version.h b/src/node_version.h
index 349d73d18d..742ea6e62e 100644
--- a/src/node_version.h
+++ b/src/node_version.h
@@ -75,47 +75,19 @@
  * Node.js will refuse to load modules that weren't compiled against its own
  * module ABI number, exposed as the process.versions.modules property.
  *
- * When this version number is changed, node.js will refuse
- * to load older modules.  This should be done whenever
- * an API is broken in the C++ side, including in v8 or
- * other dependencies.
+ * Node.js will refuse to load modules with a non-matching ABI version. The
+ * version number here should be changed whenever an ABI-incompatible API change
+ * is made in the C++ side, including in V8 or other dependencies.
  *
  * Node.js will not change the module version during a Major release line
- * We will at times update the version of V8 shipped in the release line
+ * We will, at times update the version of V8 shipped in the release line
  * if it can be made ABI compatible with the previous version.
  *
- * Module version by Node.js version:
- * Node.js v0.10.x: 11
- * Node.js v0.12.x: 14
- * Node.js v4.x: 46
- * Node.js v5.x: 47
- * Node.js v6.x: 48
- * Node.js v7.x: 51
- * Node.js v8.x: 57
- *
- * Module version by V8 ABI version:
- * V8 5.4: 51
- * V8 5.5: 52
- * V8 5.6: 53
- * V8 5.7: 54
- * V8 5.8: 55
- * V8 5.9: 56
- * V8 6.0: 57
- * V8 6.1: 58
- * V8 6.2: 59
- * V8 6.3: 60
- * V8 6.4: 61
- * V8 6.5: 62
- * V8 6.6: 63
- * V8 6.7: 64
- * V8 6.8: 65
- * V8 6.9: 66
- * V8 7.0: 67
- * V8 7.1: 68
- * V8 7.3: 71
- * V8 7.4: 72
- *
- * More information can be found at https://nodejs.org/en/download/releases/
+ * The registry of used NODE_MODULE_VERSION numbers is located at
+ *   https://github.com/nodejs/node/blob/master/doc/abi_version_registry.json
+ * Extenders, embedders and other consumers of Node.js that require ABI
+ * version matching should open a pull request to reserve a number in this
+ * registry.
  */
 #define NODE_MODULE_VERSION 72