From 83eeff71827f8462f566ec4d941a0bb59723c81e Mon Sep 17 00:00:00 2001
From: Davy De Waele <ddewaele@gmail.com>
Date: Fri, 18 Aug 2017 00:32:36 +0300
Subject: [PATCH] Fixing issue #4105 : Incorrect CLI command in Docker for
 Azure setup (#4106)

---
 docker-for-azure/index.md | 23 ++++++++++++++++++++---
 1 file changed, 20 insertions(+), 3 deletions(-)

diff --git a/docker-for-azure/index.md b/docker-for-azure/index.md
index d862fe4773..4f0cff2ba7 100644
--- a/docker-for-azure/index.md
+++ b/docker-for-azure/index.md
@@ -126,12 +126,29 @@ Docker for Azure uses SSH for accessing the Docker swarm once it's deployed. Dur
 
     ssh-keygen -y -f my-key.pem
 
+
 #### Installing with the CLI
 
-You can also invoke the Docker for Azure template from the Azure CLI:
+You can also invoke the Docker for Azure template from the [Azure CLI](https://docs.microsoft.com/cs-cz/cli/azure/install-azure-cli):
 
-Here is an example of how to use the CLI. Make sure you populate all of the parameters and their values:
+The [Docker for Azure Template](https://download.docker.com/azure/stable/Docker.tmpl) provides default values for the amount and type of managers / worker nodes, but you'll need to provide the following input :
+
+- AppID
+- AppSecret
+- Public SSH Key
+
+Below is an example of how to use the CLI. Make sure you populate all requested parameter values.
+
+The command below assumes there is a resource group called `docker-resource-group` present. This resource group can be created 
+
+- Via the Azure Portal web interface
+- Via the Azure CLI (`az group create --name docker-resource-group`)
+- Via the `docker4x/create-sp-azure` container mentioned above.
+
+If you use the AppID / AppSecret from the `docker4x/create-sp-azure` helper script, it's important it was created for the same resource-group.
 
 ```bash
-$ azure group create  --name DockerGroup --location centralus --deployment-name docker.template --template-file <templateurl>
+$ az group deployment create --resource-group docker-resource-group --name docker.template --template-uri https://download.docker.com/azure/stable/Docker.tmpl
 ```
+
+Parameters can be provided interactively, on the command line, or via a parameters file. For more info on how to use the Azure CLI, visit the [Deploy resources with Resource Manager templates and Azure CLI](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-template-deploy-cli) page.
\ No newline at end of file