edit pass: time-series-insights-how-to-add-an-event-source-eventhub

atookey · atookey · commit d164782bb125 · 2019-05-22T20:52:40.000-07:00
diff --git a/articles/time-series-insights/time-series-insights-how-to-add-an-event-source-eventhub.md b/articles/time-series-insights/time-series-insights-how-to-add-an-event-source-eventhub.md
@@ -18,7 +18,7 @@ ms.custom: seodec18
 This article describes how to use the Azure portal to add an event source that reads data from Azure Event Hubs to your Azure Time Series Insights environment.
 
 > [!NOTE]
-> The steps described in this article apply both to the Time Series Insights GA and Time Series Insights Preview environments.
+> The steps that are described in this article apply both to the Time Series Insights GA and Time Series Insights Preview environments.
 
 ## Prerequisites
 
@@ -29,7 +29,7 @@ This article describes how to use the Azure portal to add an event source that r
 
 ### Add a consumer group to your event hub
 
-Applications use consumer groups to pull data from Azure Event Hubs. Provide a dedicated consumer group, for use only by this Time Series Insights environment, to reliably read data from your event hub.
+Applications use consumer groups to pull data from Azure Event Hubs. To reliably read data from your event hub, provide a dedicated consumer group that's used only by this Time Series Insights environment.
 
 To add a new consumer group in your event hub:
 
@@ -59,37 +59,39 @@ To add a new consumer group in your event hub:
 
 1. Select the appropriate values for **Import option**:
    - If you have an existing event hub in one of your subscriptions, select **Use Event Hub from available subscriptions**. This option is the easiest approach.
-   - If the event hub is external to your subscriptions or if you want to select advanced options, select **Provide Event Hub settings manually**.
 
-   [![In the New event source pane, enter values for the first three parameters](media/time-series-insights-how-to-add-an-event-source-eventhub/2-import-option.png)](media/time-series-insights-how-to-add-an-event-source-eventhub/2-import-option.png#lightbox)
+       [![In the New event source pane, enter values for the first three parameters](media/time-series-insights-how-to-add-an-event-source-eventhub/2-import-option.png)](media/time-series-insights-how-to-add-an-event-source-eventhub/2-import-option.png#lightbox)
 
-1. The following table describes the required properties for the **Use Event Hub from available subscriptions** option:
 
-   [![Subscription and event hub details](media/time-series-insights-how-to-add-an-event-source-eventhub/3-new-event-source.png)](media/time-series-insights-how-to-add-an-event-source-eventhub/3-new-event-source.png#lightbox)
+       [![Subscription and event hub details](media/time-series-insights-how-to-add-an-event-source-eventhub/3-new-event-source.png)](media/time-series-insights-how-to-add-an-event-source-eventhub/3-new-event-source.png#lightbox)
+
+     The following table describes the required properties for the **Use Event Hub from available subscriptions** option:
 
    | Property | Description |
    | --- | --- |
-   | Subscription Id | Select the subscription in which this event hub was created.
+   | Subscription ID | Select the subscription in which this event hub was created.
    | Service bus namespace | Select the Azure Service Bus namespace that contains the event hub.
    | Event hub name | Select the name of the event hub.
    | Event hub policy name | Select the shared access policy. You can create the shared access policy on the event hub **Configure** tab. Each shared access policy has a name, permissions that you set, and access keys. The shared access policy for your event source *must* have **read** permissions.
    | Event hub policy key | The key value might be prepopulated.
    | Event hub consumer group | The consumer group that reads events from the event hub. We highly recommend that you use a dedicated consumer group for your event source. |
-   | Event serialization format | Currently, JSON is the only available serialization format. Event messages must be in this format or no data can be read. |
+   | Event serialization format | Currently, JSON is the only available serialization format. Event messages must be in this format or data can't be read. |
    | Timestamp property name | To determine this value, you need to understand the message format of the message data that's sent to the event hub. This value is the **name** of the specific event property in the message data that you want to use as the event timestamp. The value is case-sensitive. If left blank, the **event enqueue time** in the event source is used as the event timestamp. |
 
-1. The following table describes the required properties for the **Provide Event Hub settings manually** option:
+    - If the event hub is external to your subscriptions or if you want to select advanced options, select **Provide Event Hub settings manually**.
+
+        The following table describes the required properties for the **Provide Event Hub settings manually** option:
 
    | Property | Description |
    | --- | --- |
-   | Subscription Id | The subscription in which this event hub was created.
+   | Subscription ID | The subscription in which this event hub was created.
    | Resource group | The resource group in which this event hub was created.
-   | Service bus namespace | A Service Bus namespace is a container for a set of messaging entities. When you created a new event hub, you also created a Service Bus namespace.
+   | Service bus namespace | A Service bus namespace is a container for a set of messaging entities. When you created a new event hub, you also created a Service Bus namespace.
    | Event hub name | The name of your event hub. When you created your event hub, you also gave it a specific name.
    | Event hub policy name | The shared access policy. You can create a shared access policy on the event hub **Configure** tab. Each shared access policy has a name, permissions that you set, and access keys. The shared access policy for your event source *must* have **read** permissions.
    | Event hub policy key | The shared access key that's used to authenticate access to the Service Bus namespace. Enter the primary or secondary key here.
    | Event hub consumer group | The consumer group that reads events from the event hub. We highly recommend that you use a dedicated consumer group for your event source.
-   | Event serialization format | Currently, JSON is the only available serialization format. Event messages must be in this format or no data can be read. |
+   | Event serialization format | Currently, JSON is the only available serialization format. Event messages must be in this format or data can't be read. |
    | Timestamp property name | To determine this value, you need to understand the message format of the message data that's sent to the event hub. This value is the **name** of the specific event property in the message data that you want to use as the event timestamp. The value is case-sensitive. If left blank, the **event enqueue time** in the event source is used as the event timestamp. |
 
 1. Add the dedicated Time Series Insights consumer group name that you added to your event hub.
diff --git a/articles/time-series-insights/time-series-insights-how-to-add-an-event-source-iothub.md b/articles/time-series-insights/time-series-insights-how-to-add-an-event-source-iothub.md
@@ -29,13 +29,13 @@ This article describes how to use the Azure portal to add an event source that r
 
 ### Add a consumer group to your IoT hub
 
-Applications use consumer groups to pull data from Azure IoT Hub. Provide a dedicated consumer group that's used only by this Time Series Insights environment to reliably read data from your IoT hub.
+Applications use consumer groups to pull data from Azure IoT Hub. To reliably read data from your IoT hub, provide a dedicated consumer group that's used only by this Time Series Insights environment.
 
 To add a new consumer group to your IoT hub:
 
 1. In the Azure portal, find and open your IoT hub.
 
-1. In the menu, under **Settings**, select **Built-in Endpoints**, and then select the **Events** endpoint.
+1. Under **Settings**, select **Built-in Endpoints**, and then select the **Events** endpoint.
 
    [![On the Build-in Endpoints page, select the Events button](media/time-series-insights-how-to-add-an-event-source-iothub/iothub_one.png)](media/time-series-insights-how-to-add-an-event-source-iothub/iothub_one.png#lightbox)
 
@@ -64,7 +64,7 @@ To add a new consumer group to your IoT hub:
 
    [![Select options in the New event source pane](media/time-series-insights-how-to-add-an-event-source-iothub/iothub_three.png)](media/time-series-insights-how-to-add-an-event-source-iothub/iothub_three.png#lightbox)
 
-1. The following table describes the properties that are required for the **Use IoT Hub from available subscriptions** option:
+- The following table describes the properties that are required for the **Use IoT Hub from available subscriptions** option:
 
    [![New event source pane - Properties to set in the Use IoT Hub from available subscriptions option](media/time-series-insights-how-to-add-an-event-source-iothub/iothub_four.png)](media/time-series-insights-how-to-add-an-event-source-iothub/iothub_four.png#lightbox)
 
