<commit_before>## How to deploy Azure services for ConnectTheDots.io
To deploy the ConnectTheDots solution to your Azure subscription you will need to follow the below instructions.
We are using Azure Resource Manager to deploy the needed services and connect them to one another.
We are also using the Azure cross platform CLI tool which will allow you to deploy the services from your favorite development machine, running Windows, Linux or OSX.
The below services will be deployed in your Azure subscription:
   - 1 instance of Azure IoT Hub (using the SKU of your choice, considering you can only deploy 1 instance of the free SKU per subscription)
   - 1 Storage account (Standard performance)
   - 1 Service Bus instance (Basic tier) with 1 Event Hub (1 throughput Unit)
   - 1 Stream Analytics Job (1 streaming unit)
   - 1 App Service plan (Standard: 2 Small SKU) with 1 Web app
   
You can edit the [ARM template](azuredeploy.json) if you want to add more services or edit the parameters. If you edit the ARM template manually, you will have to deploy it using the command line instructions, not the "Azure Deploy Button". 

The ConnectTheDots website can allow you to manage your IoTHub instance (get devices connection strings, add/remove devices). This feature is NOT enabled by default and requires manually configuration in Active Directory described [below](#enable-iothub-management).

## Your connect the dots resource groups
All the services will be deployed under a single resource group in Azure.
The [Azure resource groups](https://azure.microsoft.com/en-us/updates/resource-groups-in-azure-preview-portal/) are a concept allowing to manage a set of resources all together.
This allows you to easily find the various resources for your ConnectTheDots solution in the Azure portal.

## Editing the deployment ARM template
The default Azure Resource Manager template doesn't require editing unless you want to change the architecture of your solution to go from the default ConnectTheDots one to your own version of it.
You can find information on how to customize the ARM template for ConnectTheDots [here](CustomizeTemplate.md).
If you edit the template file, then you will have to deploy it using the command line instructions, not the "Azure Deploy Button"

## Deploy using the Azure Deploy Button
There are several ways to deploy Azure resources to your subscription using Azure Resourre Manager templates. The simplest one is to click on the button below and follow instructions.
If you prefer command line tools, skip to the next chapter.

[![Deploy to Azure](http://azuredeploy.net/deploybutton.png)](http://azuredeploy.net/?repository=https://github.com/Azure/connectthedots/raw/IoTHubManagement/Azure/ARMTemplate)

Once you have clicked on the button, login to your subscription. You will be directed to the first step of the deployment: the setup.
<commit_msg>Updated Readme to point "button deploy" to master version of template<commit_after>## How to deploy Azure services for ConnectTheDots.io
To deploy the ConnectTheDots solution to your Azure subscription you will need to follow the below instructions.
We are using Azure Resource Manager to deploy the needed services and connect them to one another.
We are also using the Azure cross platform CLI tool which will allow you to deploy the services from your favorite development machine, running Windows, Linux or OSX.
The below services will be deployed in your Azure subscription:
   - 1 instance of Azure IoT Hub (using the SKU of your choice, considering you can only deploy 1 instance of the free SKU per subscription)
   - 1 Storage account (Standard performance)
   - 1 Service Bus instance (Basic tier) with 1 Event Hub (1 throughput Unit)
   - 1 Stream Analytics Job (1 streaming unit)
   - 1 App Service plan (Standard: 2 Small SKU) with 1 Web app
   
You can edit the [ARM template](azuredeploy.json) if you want to add more services or edit the parameters. If you edit the ARM template manually, you will have to deploy it using the command line instructions, not the "Azure Deploy Button". 

The ConnectTheDots website can allow you to manage your IoTHub instance (get devices connection strings, add/remove devices). This feature is NOT enabled by default and requires manually configuration in Active Directory described [below](#enable-iothub-management).

## Your connect the dots resource groups
All the services will be deployed under a single resource group in Azure.
The [Azure resource groups](https://azure.microsoft.com/en-us/updates/resource-groups-in-azure-preview-portal/) are a concept allowing to manage a set of resources all together.
This allows you to easily find the various resources for your ConnectTheDots solution in the Azure portal.

## Editing the deployment ARM template
The default Azure Resource Manager template doesn't require editing unless you want to change the architecture of your solution to go from the default ConnectTheDots one to your own version of it.
You can find information on how to customize the ARM template for ConnectTheDots [here](CustomizeTemplate.md).
If you edit the template file, then you will have to deploy it using the command line instructions, not the "Azure Deploy Button"

## Deploy using the Azure Deploy Button
There are several ways to deploy Azure resources to your subscription using Azure Resourre Manager templates. The simplest one is to click on the button below and follow instructions.
If you prefer command line tools, skip to the next chapter.

[![Deploy to Azure](http://azuredeploy.net/deploybutton.png)](http://azuredeploy.net/?repository=https://github.com/Azure/connectthedots/raw/master/Azure/ARMTemplate)

Once you have clicked on the button, login to your subscription. You will be directed to the first step of the deployment: the setup.

{'fraction_non_alphanumeric': 0.04668726398901476, 'fraction_numerical': 0.0037761757638173706, 'mean_word_length': 4.673807205452775, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 4, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5419382', 'n_tokens_mistral': 1371, 'n_tokens_neox': 1332, 'n_words': 838}