ARM quickstart

Author: spelluru

articles/event-hubs/event-hubs-resource-manager-namespace-event-hub.md

@@ -1,24 +1,19 @@
 ---
-title: 'Quickstart: Create an event hub with consumer group - Azure Event Hubs'
+title: 'Quickstart: Create an Azure event hub with consumer group'
 description: 'Quickstart: Create an Event Hubs namespace with an event hub and a consumer group using Azure Resource Manager templates'
 ms.topic: quickstart
 ms.custom: subject-armqs, mode-arm
 ms.date: 06/08/2021
 ---
 
 # Quickstart: Create an event hub by using an ARM template
-
-Azure Event Hubs is a Big Data streaming platform and event ingestion service, capable of receiving and processing millions of events per second. Event Hubs can process and store events, data, or telemetry produced by distributed software and devices. Data sent to an event hub can be transformed and stored using any real-time analytics provider or batching/storage adapters. For detailed overview of Event Hubs, see [Event Hubs overview](event-hubs-about.md) and [Event Hubs features](event-hubs-features.md). In this quickstart, you create an event hub by using an [Azure Resource Manager template (ARM template)](../azure-resource-manager/management/overview.md). You deploy an ARM template to create a namespace of type [Event Hubs](./event-hubs-about.md), with one event hub.
-
-[!INCLUDE [About Azure Resource Manager](../../includes/resource-manager-quickstart-introduction.md)]
-
-If your environment meets the prerequisites and you're familiar with using ARM templates, select the **Deploy to Azure** button. The template will open in the Azure portal.
-
-[![Deploy to Azure](../media/template-deployments/deploy-to-azure.svg)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.eventhub%2Feventhubs-create-namespace-and-eventhub%2Fazuredeploy.json)
+In this quickstart, you will create an event hub by using an [Azure Resource Manager template (ARM template)](../azure-resource-manager/management/overview.md). You deploy an ARM template to create a namespace of type [Event Hubs](./event-hubs-about.md), with one event hub.
 
 ## Prerequisites
 
-If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/) before you begin.
+- If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/) before you begin.
+- If you are new to Azure Event Hubs, see [Event Hubs overview](event-hubs-about.md) and [Event Hubs features](event-hubs-features.md). 
+
 
 ## Review the template
 
@@ -35,9 +30,22 @@ To find more template samples, see [Azure Quickstart Templates](https://azure.mi
 
 ## Deploy the template
 
-To deploy the template:
+### Using Azure portal user interface
+
+1. If your environment meets the prerequisites and you're familiar with using ARM templates, select the **Deploy to Azure** button. The template will open in the Azure portal. 
+
+    [![Deploy to Azure](../media/template-deployments/deploy-to-azure.svg)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.eventhub%2Feventhubs-create-namespace-and-eventhub%2Fazuredeploy.json)
+2. Select an existing **resource group** or create a resource group and select it. 
+1. Select the **region**.
+1. Enter a unique **name** for the **project**. This name will be used to generate names for an Event Hubs namespace and an event hub in the namespace. 
+1. Select **Review + create**.
+1. On the **Review + create** page, select **Create**.
+
+### Using Azure CloudShell
+
+To deploy the template using Azure Cloud Shell: 
 
-1. Select **Try it** from the following code block, and then follow the instructions to sign in to the Azure Cloud Shell.
+1. Select **Open Cloud Shell** from the following code block, and then follow the instructions to sign in to the Azure Cloud Shell.
 
    ```azurepowershell-interactive
    $projectName = Read-Host -Prompt "Enter a project name that is used for generating resource names"
@@ -55,6 +63,7 @@ To deploy the template:
 
 1. Select **Copy** to copy the PowerShell script.
 1. Right-click the shell console, and then select **Paste**.
+1. Press **ENTER** to run the commands. 
 
 ## Validate the deployment