Add doc to say user .profile needs npm config

Also a few tweaks to resolve linting suggestions.

Author: markcocker

docs/pages/cdp/cdp-Create-Zowe-CLI-profiles.md

@@ -10,50 +10,64 @@ folder: cdp
 
 ### Step 1: Create a z/OSMF profile
 
-This profile identifies the z/OSMF server that has access to the directory on z/OS into which the CICS bundle will be deployed. You need to know the following from your z/OS system administrator:
+This profile defines the parameters needed to connect to the z/OSMF server on z/OS. You need to know the following from your z/OS system administrator:
 
 | Parameter | Description |
 | --- | --- |
-| host | Hostname of the z/OSMF server. |
+| host | Host name of the z/OSMF server. |
 | port | Port number of the z/OSMF server. |
 | user | User ID to identify yourself to the z/OSMF server. |
 | password | Password to identify yourself to the z/OSMF server. |
 
+**Note**: The user ID needs to have sufficient permissions to remove and create directories and files in the directory specified by `--targetdir` in the cics-deploy profile.
+
 For example, to create a z/OSMF profile:
+
 ```console
 zowe profiles create zosmf-profile myzos --host myzos.example.com --port 3000 --user myuserid --password mypassword --reject-unauthorized false --overwrite
 ```
+
 For help on using the options:
+
 ```console
 zowe profiles create zosmf-profile --help
 ```
+
 To test the connection to the z/OSMF server using the profile:
+
 ```console
 zowe zosmf check status
 ```
 
 ### Step 2: Create an SSH profile
 
-This profile defines the parameters needed to connect. to the remote SSH server. You need to know the following from your z/OS system administrator:
+This profile defines the parameters needed to connect to the SSH server on z/OS. You need to know the following from your z/OS system administrator:
 
 | Parameter | Description |
 | --- | --- |
-| host | Hostname of the SSH server. |
+| host | Host name of the SSH server. |
 | port | Port number of the SSH server. This will default to 22. |
 | user | User ID to identify yourself to the SSH server. |
 | password | Password to identify yourself to the SSH server. |
 
-It is recommended that you use the same user ID and host to connect with SSH as is used in the z/OSMF profile, failure to do so results in undefined behaviour.
+**Note**: It is recommended that you use the same user ID and host name to connect with SSH as is used in the z/OSMF profile, failure to do so results in undefined behaviour. When an SSH connection is made, the [z/OS shell .profile](https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.3.0/com.ibm.zos.v2r3.bpxa400/cupro.htm) is used to setup the shell environment and variables. The user .profile should include enviroonment variables and npm configuration required to run `npm install` in order to resolve Node.js appplication dependencies such as compiling native code. This is descibed in 
+[Installing and configuring](https://www.ibm.com/support/knowledgecenter/SSTRRS_6.0.0/com.ibm.nodejs.zos.v6.doc/install.htm).
+
 
 For example, to create an SSH profile:
+
 ```console
 zowe profiles create ssh-profile myzos --host myzos.example.com --user myuserid --password mypassword --overwrite
 ```
+
 For help on using the options:
+
 ```console
 zowe profiles create ssh-profile --help
 ```
+
 To test the connection to the SSH server using the profile:
+
 ```console
 zowe zos-uss issue ssh 'uname -a'
 ```
@@ -68,17 +82,21 @@ This profile identifies the CICS environment for deployment. You need to know th
 | cicshlq | High Level Qualifier \(HLQ\) for the CICS data sets. |
 | cpsmhlq | High Level Qualifier \(HLQ\) for the CPSM data sets. |
 | scope | CPSM scope to identify the CICS region or group of regions to deploy your application. |
-| csdgroup | CICS CSD group name or CPSM BAS resource group name into which the bundle is defined. If not specified, BUNDLE resources are defined in CPSM BAS for installation and then removed. |
+| resgroup or basgroup | CICS CSD group name or BAS resource group name into which the bundle is defined. If not specified, BUNDLE resources are defined in CPSM BAS for installation and then removed. |
 | jobcard | JCL jobcard to use when submitting JCL that will run the CICS utility DFHDPLOY. If not specified, a default jobcard will be used. |
-| targetdir | Target zFS location to which CICS bundles should be uploaded. |
+| targetdir | Target directory on z/OS to which CICS bundles should be uploaded. |
 
 For example to create a cics-deploy profile:
+
 ```console
 zowe profiles create cics-deploy-profile example --cicsplex PLEX1 --cicshlq CICSTS55.CICS720 --cpsmhlq CICSTS55.CPSM550 --scope TESTGRP1 --csdgroup BUNDGRP1 --targetdir /var/cicsts/bundles
 --overwrite
 ```
+
 For help on using the options:
+
 ```console
 zowe profiles create cics-deploy-profile --help
 ```
+
 To test the cics-deploy profile, follow the steps in [Deploying your first app](cdp-Deploying-your-first-app).

docs/pages/cdp/cdp-Installation.md

@@ -10,22 +10,26 @@ toc: false
 ---
 
 1. Install [Node.js V8.0](https://nodejs.org/en/download/) or later, and Node Package Manager (npm) V5.0 or later, that are required by Zowe CLI. To verify the versions installed:
+
    ```console
    node --version
    npm --version
    ```
 
 2. Install [Zowe CLI](https://zowe.github.io/docs-site/latest/user-guide/cli-installcli.html). For example to install using npm:
+
    ```console
    npm install -g zowe-cli
    ```
 
 3. Install the cics-deploy plugin:
+
    ```console
    zowe plugins install zowe-cli-cics-deploy-plugin
    ```
 
 4. Verify the version of the plugin that is installed:
+
    ```console
    zowe plugins list
    ```

docs/pages/cdp/cdp-Requirements.md

@@ -10,14 +10,17 @@ toc: false
 ---
 
 ### z/OS Management Facility
+
 A [z/OS Management Facility (z/OSMF)](https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.3.0/com.ibm.zos.v2r3.izua300/IZUHPINFO_PartConfiguring.htm) server is required to run the [push bundle](Commands#command-push-bundle), [deploy bundle](Commands#command-deploy-bundle), and [undeploy bundle](Commands#command-undeploy-bundle) commands. These commands call the API for [`zowe zos-jobs submit`](https://zowe.github.io/docs-site/latest/user-guide/cli-usingcli.html#zos-jobs) to submit JCL that executes the DFHDPLOY utility to deploy and undeploy CICS bundles.
 
 The z/OSMF server is also required by the [push bundle](Commands#command-push-bundle) command when it uses the API for [`zowe files upload dir-to-uss`](https://github.com/zowe/zowe-cli/issues/207) to copy a CICS bundle to a z/OS directory.
 
 ### z/OS Secure SHell daemon
+
 The [z/OS Secure SHell daemon (sshd)](https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.3.0/com.ibm.zos.v2r3.foto100/sshset.htm) is required to run the [push bundle](Commands#command-push-bundle) command. This command uses the API for [`zowe zos-uss issue ssh`](https://github.com/zowe/zowe-cli/pull/308) to remove old files from the CICS bundle directory on z/OS and execute `npm install` on z/OS to install dependencies for Node.js applications.
 
 ### DFHDPLOY utility
+
 The [DFHDPLOY](https://www.ibm.com/support/knowledgecenter/SSGMCP_5.5.0/applications/deploying/dfhdploy_overview.html) utility is provided with IBM CICS Transaction Server (CICS) and is required to run the [push bundle](Commands#command-push-bundle), [deploy bundle](Commands#command-deploy-bundle), and [undeploy bundle](Commands#command-undeploy-bundle) commands. These commands start DFHDPLOY with a script to perform deploy and undeploy operations. For example the deploy operation will define, install, then enable a CICS BUNDLE resource in a one or more CICS regions.
 
 The DFHDPLOY utility requires CICSPlex System Manager \(CPSM\) that is also provided with CICS to be configured, and for CPSM to be connected to the target CICS regions.