Update tutorial to be Node.js specific

Author: markcocker

docs/_data/sidebars/cdp_sidebar.yml

@@ -24,8 +24,8 @@ entries:
   - title: Tutorials
     output: web
     folderitems:
-    - title: Deploying your first app
-      url: /cdp-Deploying-your-first-app.html
+    - title: Deploying your first Node.js app
+      url: /cdp-Deploying-your-first-nodejs-app.html
       output: web
     - title: Deploying using individual actions
       url: /cdp-Deploying-using-individual-actions.html

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

@@ -96,4 +96,4 @@ For help on using the options:
 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).
+To test the cics-deploy profile, follow the steps in [Deploying your first Node.js app](cdp-Deploying-your-first-nodejs-app).

docs/pages/cdp/cdp-Deploying-into-zospt-cics-region.md

@@ -84,7 +84,7 @@ zospt build $ZOSPTIMAGE -t cics_55_nodejs
    zowe profiles update cics-deploy cics --scope CICPY000 --bundle-directory /u/cicprov/mnt/CICPY000/bundles
    ```
 
-4. Deploy your Node.js application to the CICS region using the steps in [Deploying your first app](cdp-Deploying-your-first-app). For example:
+4. Deploy your Node.js application to the CICS region using the steps in [Deploying your first Node.js app](cdp-Deploying-your-first-nodejs-app). For example:
 
    ```console
    zowe cics-deploy push bundle --name Express --overwrite

docs/pages/cdp/cdp-Deploying-using-individual-actions.md

@@ -9,7 +9,7 @@ folder: cdp
 toc: false
 ---
 
-The `zowe cics-deploy push bundle` command performs a set of actions to deploy applications to CICS, as can be seen in [Deploying your first app](cdp-cdp-Deploying-your-first-app). The main actions include:
+The `zowe cics-deploy push bundle` command performs a set of actions to deploy applications to CICS, as can be seen in [Deploying your first Node.js app](cdp-Deploying-your-first-nodejs-app). The main actions include:
 
 * undeploy the old version of the CICS bundle in CICS
 * upload the new version of the CICS bundle to z/OS

docs/pages/cdp/cdp-Deploying-your-first-app.md renamed to docs/pages/cdp/cdp-Deploying-your-first-nodejs-app.md

@@ -1,10 +1,10 @@
 ---
-title: Deploying your first app
+title: Deploying your first Node.js app
 tags: [getting_started]
 keywords:
-summary: "The following steps take you through deploying your first Node.js application to CICS."
+summary: "The following steps take you through deploying your first Node.js application to CICS using the Express Application Generator."
 sidebar: cdp_sidebar
-permalink: cdp-Deploying-your-first-app.html
+permalink: cdp-Deploying-your-first-nodejs-app.html
 folder: cdp
 toc: false
 ---
@@ -13,9 +13,7 @@ toc: false
 
 2. Create Zowe CLI profiles for z/OSMF, SSH, and cics-deploy by following the steps in [Create Zowe CLI profiles](cdp-Create-Zowe-CLI-profiles).
 
-3. Create a Node.js application.
-
-   For example, to create a Node.js application using the [Express Application Generator](https://expressjs.com/en/starter/generator.html):
+3. Create a Node.js application using the [Express Application Generator](https://expressjs.com/en/starter/generator.html):
 
    ```console
    npm install -g express-generator
@@ -29,15 +27,15 @@ toc: false
 
 4. Package the Node.js application into a [CICS bundle](cdp-cics-bundles).
 
-    Make sure you are in the root directory of the application. Replace the value for `--port` with one that is available for use by the CICS region on z/OS.
+    Make sure you are in the root directory of the application. Replace the value for the `--port` option with one that is available for use by the CICS region on z/OS.
 
    ```console
     zowe cics-deploy generate bundle --port 3000 --overwrite
    ```
 
     The output will show the directories and files created to form a CICS bundle. For example:
 
-    ```console
+    <pre class="messageText">
     define : NODEJSAPP "myexpressapp" with startscript "./bin/www"
     create : nodejsapps
     create : nodejsapps/myexpressapp.nodejsapp
@@ -46,11 +44,11 @@ toc: false
     create : META-INF
     create : META-INF/cics.xml
     CICS Bundle generated with bundleid "myexpressapp"
-    ```
+    </pre>
 
 5. Update the CICS Node.js application profile if your application requires environment variables to be set.
 
-    Edit the `.profile` file created in step 4, for example `nodejsapps/myexpressapp.profile`.
+    Edit the `.profile` file created in step 4, for example `nodejsapps/myexpressapp.profile` to add the environment varaiables.
 
 6. Deploy the CICS bundle into CICS.
 
@@ -70,4 +68,6 @@ toc: false
 
 ### Results
 
-The Node.js application is packaged into a CICS bundle on the workstation, uploaded to a directory on z/OS, and is running in CICS.
+The Node.js application is packaged into a CICS bundle on the workstation, uploaded to a directory on z/OS, and is running in CICS.
+
+{% include tip.html content="[Best practice for developing Node.js applications](https://www.ibm.com/support/knowledgecenter/SSGMCP_5.5.0/applications/developing/node/best-practice.html) provides guidance on using environment variables and graceful application termination." %}

docs/pages/cdp/cdp-Home.md

@@ -10,7 +10,7 @@ folder: cdp
 
 It provides a Node.js CICS deployment workflow for developers and CI/CD automation pipelines similar to that experienced when deploying Node.js applications to the cloud.
 
-Before you start, and especially if you are not familiar with the world of z/OS, Zowe and CICS, it's a good idea to read about some of the key concepts, which include [Zowe](cdp-zowe-and-cli), [Zowe CLI profiles](cdp-zowe-profiles) and [CICS bundles](cdp-cics-bundles). If you're keen to get going quickly, you can jump right in and follow along with our tutorial on [Deploying your first app](cdp-Deploying-your-first-app).
+Before you start, and especially if you are not familiar with the world of z/OS, Zowe and CICS, it's a good idea to read about some of the key concepts, which include [Zowe](cdp-zowe-and-cli), [Zowe CLI profiles](cdp-zowe-profiles) and [CICS bundles](cdp-cics-bundles). If you're keen to get going quickly, you can jump right in and follow along with our tutorial on [Deploying your first Node.js app](cdp-Deploying-your-first-nodejs-app).
 
 When everything has been [installed](cdp-Installation) and [you've created the Zowe CLI profiles](cdp-Create-Zowe-CLI-profiles), you can deploy a Node.js application from your workstation to CICS in two steps: