docs(docs): add overview docs for Node plugin (#2724)

docs/map.json

@@ -456,6 +456,11 @@
             "name": "node",
             "id": "node",
             "itemList": [
+              {
+                "id": "overview",
+                "name": "Overview",
+                "file": "shared/node-plugin"
+              },
               {
                 "id": "schematics",
                 "name": "Schematics",

docs/shared/node-plugin.md

@@ -0,0 +1,153 @@
+# Node Plugin
+
+The Node Plugin contains schematics and builders to manage Node applications within an Nx workspace.
+
+## Installing the Node Plugin
+
+Installing the Node plugin to a workspace can be done with the following:
+
+```shell script
+#yarn
+yarn add -D @nrwl/node
+```
+
+```shell script
+#npm
+npm install -D @nrwl/node
+```
+
+## Applications
+
+Generating new applications can be done with the following:
+
+```shell script
+nx generate @nrwl/node:application <node-app>
+```
+
+This creates the following app structure:
+
+```treeview
+my-org/
+├── apps/
+    └── node-app/
+        ├── jest.config.js
+        ├── src/
+        │   ├── app/
+        │   ├── assets/
+        │   ├── environments/
+        │   │   ├── environment.prod.ts
+        │   │   └── environment.ts
+        │   └── main.ts
+        ├── tsconfig.app.json
+        ├── tsconfig.json
+        ├── tsconfig.spec.json
+        └── tslint.json
+```
+
+From here files can be added within the `app` folder.
+Make sure to import any files within the `main.ts` file so that they can be executed when the application is ran.
+
+#### Application Proxies
+
+Generating Node applications has an option to configure other projects in the workspace to proxy API requests. This can be done by passing the `--frontendProject` with the project name you wish to enable proxy support for.
+
+```shell script
+nx generate @nrwl/node:application <node-app> --frontendProject my-react-app
+```
+
+### Application commands
+
+When a Node application is added to the workspace.json (or angular.json), the following architect commands are available for execution:
+
+#### build
+
+```shell script
+nx build <node-app>
+```
+
+The build command will compile the application using Webpack. It supports a production configuration by building with the following command:
+
+```shell script
+nx build <node-app> --configuration=production
+```
+
+Additional configurations can be added in the workspace.json. Changing the `--configuration` flag with the new configuration name will run that config.
+
+#### serve
+
+```shell script
+nx serve <node-app>
+```
+
+The serve command runs the `build` target, and executes the application.
+
+By default, the serve command will run in watch mode. This allows code to be changed, and the Node application to be rebuilt automatically.
+Node applications also have the `inspect` flag set, so you can attach your debugger to the running instance.
+
+##### Debugging
+
+Debugging is set to use a random port that is available on the system. The port can be changed by setting the port option in the `serve` architect in the workspace.json. Or by running the serve command with `--port <number>`.
+
+For additional information on how to debug Node applications, see the [Node.js debugging getting started guide](https://nodejs.org/en/docs/guides/debugging-getting-started/#inspector-clients).
+
+#### lint
+
+The lint command will run linting within the scope of the Node app.
+
+```shell script
+nx lint <node-app>
+```
+
+#### test
+
+Test will execute Jest tests within the scope of the Node app.
+
+```shell script
+nx test <node-app>
+```
+
+## Libraries
+
+Node libraries are a good way to separate features within your organization. To create a Node library run the following command:
+
+```shell script
+nx generate @nrwl/node:library <node-lib>
+```
+
+#### Buildable libraries
+
+Libraries can also be enabled to be built separately from apps. To create a buildable library, add the `--buildable` flag to the generate command above.
+
+```shell script
+nx generate @nrwl/node:library <node-lib> --buildable
+```
+
+### Library commands
+
+When a Node library is added to the workspace.json (or angular.json), the following architect commands are available for execution:
+
+#### lint
+
+The lint command will run linting within the scope of the Node library.
+
+```shell script
+nx lint <node-lib>
+```
+
+#### test
+
+Test will execute Jest tests within the scope of the Node library.
+
+```shell script
+nx test <node-lib>
+```
+
+#### build
+
+The build command will only be available if the library was generated with the `--buildable` flag.
+
+Buildable Node libraries use TypeScript to compile the source. The tsconfig files that are generated with the library allow customization of the compiled output.
+
+```shell script
+nx build <node-lib>
+```