diff --git a/doc/api/modules.md b/doc/api/modules.md index cd94950efde855..15312509be1dec 100644 --- a/doc/api/modules.md +++ b/doc/api/modules.md @@ -2,12 +2,12 @@ -> Stability: 2 - Stable +> Stability: 3 - Legacy: Use [ECMAScript modules][] instead. -CommonJS modules are the original way to package JavaScript code for Node.js. -Node.js also supports the [ECMAScript modules][] standard used by browsers +CommonJS modules are the legacy way to package JavaScript code for Node.js. +Node.js supports the [ECMAScript modules][] standard used by browsers and other JavaScript runtimes. In Node.js, each file is treated as a separate module. For