Review NodeJS

olyagpl · olyagpl · commit 77569fae1d96 · 2020-10-15T14:32:53.000+03:00
diff --git a/docs/user/NodeJS.md b/docs/user/NodeJS.md
@@ -5,26 +5,30 @@ Applications can freely import and use NPM packages, including native ones.
 
 ## Running Node.js Applications
 
-To run Node.js-based applications, use the `node` binary executable in the GraalVM distribution:
-```
+To run Node.js-based applications, use the `node` launcher in the GraalVM distribution:
+```shell
 $GRAALVM_HOME/bin/node [options] [filename] [args]
 ```
 
-GraalVM's Node.js is based on a recent version of Node.js, and runs the GraalVM JavaScript engine instead of Google V8. Thus, some internal features (e.g., VM-internal statistics or configuration, profiling, debugging, etc.) are unsupported, or supported with potentially different behavior.
+GraalVM's Node.js runtime is based on a recent version of Node.js, and runs the
+GraalVM JavaScript engine instead of Google V8. Thus, some internal features (e.g.,
+VM-internal statistics, configuration, profiling, debugging, etc.) are
+unsupported, or supported with potentially different behavior.
 
-The `node` executable is largely compatible with Node.js, and features additional GraalVM-specific functionalities (e.g., interoperability with Java and all other GraalVM languages).
+The `node` command is largely compatible with Node.js, and features additional GraalVM-specific functionalities (e.g., interoperability with Java and all other GraalVM languages).
 A list of available options can be obtained with `node --help`.
 
 ## Installing Packages Using `npm`
 
-To install a Node.js package, you can use the `npm` executable in the `$GRAALVM_HOME/bin` folder of GraalVM.
-The `npm` executable is equivalent to the default NPM command, and supports most of its options.
+To install a Node.js package, you can use the `npm` launcher from the GraalVM's `/bin` folder.
+The `npm` command is equivalent to the default NPM command, and supports most of its options.
 
 An NPM package can be installed with:
-```
+```shell
 $GRAALVM_HOME/bin/npm install <package>
 ```
-As the `npm` executable of GraalVM is largely compatible with NPM, packages will be installed in the `node_modules` folder, as expected.
+
+As the `npm` command of GraalVM is largely compatible with NPM, packages will be installed in the `node_modules` folder, as expected.
 
 ### Installing `npm` Packages Globally
 
@@ -33,7 +37,7 @@ By default, `npm` installs global packages in the path where the `node` executab
 In GraalVM, this means that global packages will create files in the GraalVM folder.
 To avoid writing to the GraalVM folder, the default global installation folder of `npm` can be modified by setting the `$PREFIX` environment variable, or by specifying the `--prefix` option when running `npm install`.
 For example, the following command will install global packages in the `/foo/bar` folder:
-```
+```shell
 $GRAALVM_HOME/bin/npm install --prefix /foo/bar -g <package>
 ```
-More details about `prefix` can be found in the official npm documentation.
+More details about `prefix` can be found in the [official NPM documentation](https://docs.npmjs.com/cli/prefix.html).
diff --git a/docs/user/README.md b/docs/user/README.md
@@ -12,7 +12,7 @@ engines, migration guides are available.
 
 ## Running JavaScript
 
-GraalVM can execute plain JavaScript code:
+GraalVM can run plain JavaScript code:
 ```shell
 js [options] [filename...] -- [args]
 ```
@@ -26,7 +26,7 @@ To run Node.js-based applications, use the `node` utility bundled with GraalVM b
 node [options] [filename] [args]
 ```
 
-To install a Node.js module, use the `npm` executable from the GraalVM's `/bin` folder. The `npm` command is equivalent to the default Node.js command and supports all Node.js APIs.
+To install a Node.js module, use the `npm` launcher from the GraalVM's `/bin` folder. The `npm` executable is equivalent to the default Node.js command and supports all Node.js APIs.
 
 1&#46; Install the `colors` and `ansispan` modules using `npm install` as
 follows:
