diff --git a/deploy/az/readme.md b/deploy/az/readme.md
index 3fa56e885..803dc19b5 100644
--- a/deploy/az/readme.md
+++ b/deploy/az/readme.md
@@ -1,20 +1,20 @@
 
 # Deploying resources using create-resources script
 
-The `create-resources` script is a basic script to allow easy deployment of one ARM template in one resource group. You can deploy to an existing resource group or to create one.
+The `create-resources.cmd ` script is a basic script to allow easy deployment of one ARM template in one resource group. You can deploy to an existing resource group or to create one.
 
-NOTE: Alternatively, you can also use the createresources.sh bash script which was created as a second option, convenient if you are using a Mac or Linux machine, or simply, bash on Windows, instead of CMD/CommandPrompt in Windows.
+NOTE: Alternatively, you can also use the `createresources.sh` bash script which was created as a second option, convenient if you are using a Mac or Linux machine, or simply, bash on Windows, instead of CMD/CommandPrompt in Windows.
 
 ## Deploying to a existing resource group
 
-Just type `create-resources path-to-arm-template resourcegroup`. Called this way the script will:
+Just type `create-resources [pathfile-to-arm-template] resourcegroup` from command-prompt. Called this way the script will:
 
 1. Search for `path-to-arm-template.json` and `path-to-arm-template.parameters.json` files
-2. If they exist, will deploy them in the `resourcegroup` specified (that has to exist).
+2. If they exist, will deploy them in the `resourcegroup` specified (that resource group in Azure has to exist).
 
 ## Deploying to a new resource group
 
-Just type `create-resources path-to-arm-template resourcegroup -c location`. Called this way the script will:
+Just type `create-resources [pathfile-to-arm-template] resourcegroup -c location`. Called this way the script will:
 
 1. Search for `path-to-arm-template.json` and `path-to-arm-template.parameters.json` files
 2. If they exist, will create the `resourcegroup` specified in the `location` specified.