improve docs

Author: kurowski

local/etc/uceap.d/deploy-to-dev.sh

@@ -6,9 +6,9 @@ function deploy_to_dev() {
 	terminus connection:set git -y
 }
 
-_deploy_to_dev_desc='deploys the local code to the Pantheon DEV environment'
+_deploy_to_dev_desc='deploys code from local filesystem to Pantheon DEV environment'
 _deploy_to_dev_help='
-Deploys the local code to the Pantheon DEV environment.
+Deploys code from local filesystem to the Pantheon DEV environment.
 
 # Usage
 

local/etc/uceap.d/deploy-to-live.sh

@@ -6,9 +6,9 @@ function deploy_to_live() {
 	_pantheon_deploy
 }
 
-_deploy_to_live_desc='deploys the local code to the Pantheon LIVE environment'
+_deploy_to_live_desc='deploys the code on Pantheon from TEST to LIVE'
 _deploy_to_live_help='
-Deploys the local code to the Pantheon LIVE environment.
+Deploys the code on Pantheon from TEST to LIVE.
 
 # Usage
 

local/etc/uceap.d/deploy-to-multidev.sh

@@ -2,9 +2,9 @@ function deploy_to_multidev() {
 	_deploy_code
 }
 
-_deploy_to_multidev_desc='deploys the local code to a Pantheon multidev'
+_deploy_to_multidev_desc='deploys code from local filesystem to a Pantheon multidev'
 _deploy_to_multidev_help='
-Deploys the local code to a Pantheon multidev.
+Deploys code from local filesystem to a Pantheon multidev.
 
 # Usage
 

local/etc/uceap.d/deploy-to-test.sh

@@ -14,9 +14,9 @@ function deploy_to_test() {
 	_pantheon_deploy
 }
 
-_deploy_to_test_desc='deploys the local code to the Pantheon TEST environment'
+_deploy_to_test_desc='deploys the code on Pantheon from DEV to TEST'
 _deploy_to_test_help='
-Deploys the local code to the Pantheon TEST environment.
+Deploys the code on Pantheon from DEV to TEST.
 
 # Usage
 

local/etc/uceap.d/devcontainer_update_content.sh

@@ -16,7 +16,7 @@ function devcontainer_update_content() {
 	fi
 }
 
-_devcontainer_update_content_desc='runs when the devcontainer needs to update content'
+_devcontainer_update_content_desc='runs when devcontainer content needs updating'
 _devcontainer_update_content_help='
 This command implements the `updateContentCommand` lifecycle event for dev containers.
 

local/etc/uceap.d/help.sh

@@ -24,10 +24,10 @@ function _help() {
 		echo
 	done
 	echo
-	echo 'Please run **uceap \<command\>** to execute a command.'
-	echo 'Please run **uceap help \<command\>** to see the help for a command.'
+	echo 'Please run `uceap <command>` to execute a command.'
+	echo 'Please run `uceap help <command>` to see the help for a command.'
 }
-_help_desc='displays help for `uceap` commands'
+_help_desc='displays help for uceap commands'
 _help_help='
 Show help for UCEAP CLI commands.
 

local/etc/uceap.d/refresh_content.sh

@@ -25,9 +25,9 @@ function refresh_content() {
 	rm $DATABASE_BACKUP
 }
 
-_refresh_content_desc='refreshes code, files, and database'
+_refresh_content_desc='refreshes code, files, and database in devcontainer'
 _refresh_content_help='
-Refreshes local code, files, and database.
+Refreshes local code, files, and database in devcontainer.
 
 # Usage