Merge pull request #299 from markcocker/dev

Add doc for return code

Author: markcocker

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

@@ -9,13 +9,7 @@ folder: cdp
 toc: false
 ---
 
-The Zowe CLI lets you define arguments and options for commands in multiple ways, with the following order of precedence:
-
-1. Command-line
-2. Environment variables
-3. Profiles
-
-Therefore by creating and setting options in the following profiles, they will become your defaults and you do not need to repeat them when using Zowe CLI commands unless you wish to override them. Further details are in [Understanding command option order of precedence](https://zowe.github.io/docs-site/latest/user-guide/cli-configuringcli.html#understanding-command-option-order-of-precedence).
+See [Zowe CLI profiles](cdp-zowe-profiles) for an overview of profiles.
 
 The CICS® deploy plug-in makes use of the following profiles:
 

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

@@ -16,7 +16,7 @@ The `zowe cics-deploy push bundle` command performs a set of actions to deploy a
 * resolve Node.js application dependencies on z/OS
 * deploy the CICS bundle in CICS
 
-However, there may be situations where you need more control of these actions or perform alternate actions. The following sections describe how each of these actions can be performed independently, enabling you to form a sequence of commands to achieve your needs.
+However, there may be situations where you need more control of these actions or perform alternate actions. The following sections describe how each of these actions can be performed independently, enabling you to form a sequence of commands to achieve your needs. Zowe CLI commands set the return code to 0 when the command completed successfully, or greater than 0 if the command failed.
 
 ### Undeploy a CICS bundle
 

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

@@ -47,9 +47,20 @@ As suggested above, to deploy a Node.js application from your workstation to one
 
 Ultimately, you are not *required* to use Zowe CLI profiles - you can specify all of the required command-line arguments explicitly - but they reduce the burden of typing when you are issuing commands that require many arguments.
 
+### Order of precedence
+
+The Zowe CLI lets you define arguments and options for commands in multiple ways, with the following order of precedence:
+
+1. Command-line
+2. Environment variables
+3. Profiles
+
+Therefore by setting options in a profile they will become your default and you do not need to repeat them on the command-line unless you wish to override them. Further details are in [Understanding command option order of precedence](https://zowe.github.io/docs-site/latest/user-guide/cli-configuringcli.html#understanding-command-option-order-of-precedence).
+
 ### Where are Zowe CLI profiles stored?
 
-When you create a Zowe CLI profile, a representation is written to an operating-system-dependent text file on your local workstation.
+When you create a Zowe CLI profile, a representation is written to a file on your local workstation in plain text. This file may contain sensitive information such as user IDs and passwords and therefore needs to be secured. Further details are in [Creating Zowe CLI profiles](https://zowe.github.io/docs-site/latest/user-guide/cli-configuringcli.html#creating-zowe-cli-profiles).
+
 <ul id="profileTabs" class="nav nav-tabs">
     <li class="active"><a href="#windows" data-toggle="tab">Windows</a></li>
     <li><a href="#linux" data-toggle="tab">Linux</a></li>