Freshness. Links and Acrolinx.

Author: TimShererWithAquent

articles/event-grid/includes/enable-identity-portal.md

@@ -11,14 +11,15 @@ ms.custom: include file
 
 ## Enable managed identity for the Event Grid namespace 
 
-1. On the **Event Grid Namespace** page, select **Identity** under **Settings** on the left menu.  
+1. On the **Event Grid Namespace** page, select **Identity** under **Settings** on the left menu.
 1. Turn **on** the switch to enable a system-assigned managed identity.
 1. Select **Save** on the toolbar to save the setting.
 
-    :::image type="content" source="./media/enable-identity-portal/event-grid-enable-managed-identity.png" alt-text="Screenshot of a system-assigned identity page for an Event Grid namespace." lightbox="./media/enable-identity-portal/event-grid-enable-managed-identity.png":::
+   :::image type="content" source="./media/enable-identity-portal/event-grid-enable-managed-identity.png" alt-text="Screenshot of a system-assigned identity page for an Event Grid namespace." lightbox="./media/enable-identity-portal/event-grid-enable-managed-identity.png":::
+
 1. Select **Yes** on the confirmation message.
 1. Confirm that you see the object ID of the system-assigned managed identity and see a link to assign roles.
 
-    :::image type="content" source="./media/enable-identity-portal/event-grid-enable-managed-identity-confirmation.png" alt-text="Screenshot that shows assigning identity to a namespace is completed." lightbox="./media/enable-identity-portal/event-grid-enable-managed-identity-confirmation.png":::
+   :::image type="content" source="./media/enable-identity-portal/event-grid-enable-managed-identity-confirmation.png" alt-text="Screenshot that shows assigning identity to a namespace is completed." lightbox="./media/enable-identity-portal/event-grid-enable-managed-identity-confirmation.png":::
 
-    Check notifications in the portal to confirm that the managed identity is enabled for the namespace.
+   Check notifications in the portal to confirm that the managed identity is enabled for the namespace.

articles/event-grid/includes/enable-mqtt-portal.md

@@ -15,6 +15,6 @@ ms.custom: include file
 1. Select the check box next to **Enable MQTT broker**. 
 1. Select **Apply** at the bottom of the page.
 
-    :::image type="content" source="./media/enable-mqtt-portal/enable-mqtt.png" alt-text="Screenshot showing Event Grid namespace configuration page to enable MQTT." lightbox="./media/enable-mqtt-portal/enable-mqtt.png":::
+   :::image type="content" source="./media/enable-mqtt-portal/enable-mqtt.png" alt-text="Screenshot showing Event Grid namespace configuration page to enable MQTT." lightbox="./media/enable-mqtt-portal/enable-mqtt.png":::
 
-    Check notifications in the portal to confirm that the MQTT broker is enabled for the namespace.
+   Check notifications in the portal to confirm that the MQTT broker is enabled for the namespace.

articles/event-grid/includes/event-grid-create-namespace-portal.md

@@ -12,7 +12,7 @@ ms.custom:
 ---
 
 ## Create a namespace in the Azure portal
-A namespace in Azure Event Grid is a logical container for one or more topics, clients, client groups, topic spaces and permission bindings. It provides a unique namespace, allowing you to have multiple resources in the same Azure region. With an Azure Event Grid namespace you can group now together related resources and manage them as a single unit in your Azure subscription.
+A namespace in Azure Event Grid is a logical container for one or more topics, clients, client groups, topic spaces and permission bindings. It provides a unique namespace, allowing you to have multiple resources in the same Azure region. With an Azure Event Grid namespace, you can group now together related resources and manage them as a single unit in your Azure subscription.
 
 Please follow the next sections to create, view and manage an Azure Event Grid namespace.
 
@@ -21,17 +21,21 @@ To create a namespace:
 1. Sign-in to the [Azure portal](https://portal.azure.com).
 1. In the **search box**, enter **Event Grid Namespaces** and select **Event Grid Namespaces** from the results.
 
-    :::image type="content" source="../media/create-view-manage-namespaces/portal-search-box-namespaces.png" alt-text="Screenshot showing Event Grid Namespaces in the search results.":::
+   :::image type="content" source="../media/create-view-manage-namespaces/portal-search-box-namespaces.png" alt-text="Screenshot showing Event Grid Namespaces in the search results.":::
+
 1. On the **Event Grid Namespaces** page, select **+ Create** on the toolbar. 
 
-    :::image type="content" source="../media/create-view-manage-namespaces/namespace-create-button.png" alt-text="Screenshot showing Event Grid Namespaces page with the Create button on the toolbar selected.":::
+   :::image type="content" source="../media/create-view-manage-namespaces/namespace-create-button.png" alt-text="Screenshot showing Event Grid Namespaces page with the Create button on the toolbar selected.":::
+
 1. On the **Basics** page, follow these steps.
+
     1. Select the **Azure subscription** in which you want to create the namespace.
     1. Select an existing **resource group** or create a resource group.
     1. Enter a **name** for the namespace.
     1. Select the region or **location** where you want to create the namespace. 
     1. Select **Review + create** at the bottom of the page. 
 
-        :::image type="content" source="../media/create-view-manage-namespaces/create-namespace-basics-page.png" alt-text="Screenshot showing the Basics tab of Create namespace page.":::        
-6. On the **Review + create** tab, review your settings and select **Create**.
+       :::image type="content" source="../media/create-view-manage-namespaces/create-namespace-basics-page.png" alt-text="Screenshot showing the Basics tab of Create namespace page.":::
+
+1. On the **Review + create** tab, review your settings and select **Create**.
 1. On the **Deployment succeeded** page, select **Go to resource** to navigate to your namespace. 

articles/event-grid/includes/event-grid-create-namespace-topic-portal.md

@@ -12,10 +12,11 @@
 ## Create a namespace topic
 
 1. If you aren't on the Event Grid Namespace page, follow the [create, view, and manage namespaces](../create-view-manage-namespaces.md) steps to view the namespace you want to use to create the topic.
-2. On the **Event Grid Namespace** page, select **Topics** option in the **Event broker** section on the left menu.
-3. On the **Topics** page, select **+ Topic** button on the command bar.
+1. On the **Event Grid Namespace** page, select **Topics** option in the **Event broker** section on the left menu.
+1. On the **Topics** page, select **+ Topic** button on the command bar.
 
-    :::image type="content" source="../media/create-view-manage-namespace-topics/namespace-topic-creation.png" alt-text="Screenshot showing Event Grid namespace topic creation." lightbox="../media/create-view-manage-namespace-topics/namespace-topic-creation.png":::
-4. On the **Create Topic** page, type the name of the topic you want to create and select **Create**.
+   :::image type="content" source="../media/create-view-manage-namespace-topics/namespace-topic-creation.png" alt-text="Screenshot showing Event Grid namespace topic creation." lightbox="../media/create-view-manage-namespace-topics/namespace-topic-creation.png":::
 
-    :::image type="content" source="../media/create-view-manage-namespace-topics/namespace-topic-creation-basics.png" alt-text="Screenshot showing Event Grid namespace topic creation basics.":::
+1. On the **Create Topic** page, type the name of the topic you want to create and select **Create**.
+
+   :::image type="content" source="../media/create-view-manage-namespace-topics/namespace-topic-creation-basics.png" alt-text="Screenshot showing Event Grid namespace topic creation basics.":::

articles/event-grid/mqtt-routing-to-event-hubs-portal-namespace-topics.md

@@ -41,22 +41,28 @@ In a separate tab of the Web browser or in a separate window, use the Azure port
 1. On the **Event Hubs Namespace** page, select **Access control (IAM)** on the left menu.
 1. On the **Access control** page, select **+ Add** on the command bar, and then select **Add role assignment**.
 
-    :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/event-hubs-access-control-add-role-assignment.png" alt-text="Screenshot that shows the Access control page for the Event Hubs namespace.":::
+   :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/event-hubs-access-control-add-role-assignment.png" alt-text="Screenshot that shows the Access control page for the Event Hubs namespace.":::
+
 1. On the **Add role assignment** page, select **Azure Event Hubs Data Sender** from the list of roles, and then select **Next** at the bottom of the page.
 
-    :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/select-azure-event-hubs-data-sender.png" alt-text="Screenshot that shows the Add role assignment page with Azure Event Hubs Data Sender selected.":::
+   :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/select-azure-event-hubs-data-sender.png" alt-text="Screenshot that shows the Add role assignment page with Azure Event Hubs Data Sender selected.":::
+
 1. On the **Members** page, follow these steps:
-    1. For the **Assign access to** field, select **Managed identity**. 
-    1. Choose **+ Select members**.
 
-        :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/select-managed-identity.png" alt-text="Screenshot that shows the Add role assignment page with Managed identity selected.":::
+   1. For the **Assign access to** field, select **Managed identity**. 
+   1. Choose **+ Select members**.
+
+      :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/select-managed-identity.png" alt-text="Screenshot that shows the Add role assignment page with Managed identity selected.":::
+
 1. On the **Select managed identities** page, follow these steps:
+
     1. Select your **Azure subscription**. 
     1. For **Managed identity**, select **Event Grid Namespace**.
     1. Select the managed identity that has the same name as the Event Grid namespace. 
     1. Choose **Select** at the bottom of the page.
 
-        :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/select-event-grid-namespace-managed-identity.png" alt-text="Screenshot that shows the Select managed identities page with the Event Grid namespace's managed identity selected.":::          
+       :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/select-event-grid-namespace-managed-identity.png" alt-text="Screenshot that shows the Select managed identities page with the Event Grid namespace's managed identity selected.":::
+
 1. On the **Add role assignment** page, select **Review + assign** at the bottom of the page.
 1. On the **Review + assign** page, select **Review + assign**. 
 
@@ -66,44 +72,50 @@ In a separate tab of the Web browser or in a separate window, use the Azure port
 1. On the **Event Grid Namespace** page, select **Topics** on the left menu.
 1. On the **Topics** page, select the namespace topic you created earlier.
 
-   :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/select-topic.png" alt-text="Screenshot that shows the Topics page with the namespace topic selected.":::              
+   :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/select-topic.png" alt-text="Screenshot that shows the Topics page with the namespace topic selected.":::
+
 1. On the **Event Grid Namespace Topic** page, select **+ Subscription** on the command bar at the top.
 
-   :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/subscriptions-page.png" alt-text="Screenshot that shows the Subscriptions page.":::              
+   :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/subscriptions-page.png" alt-text="Screenshot that shows the Subscriptions page.":::
+
 1. On the **Create Subscription** page, follow these steps:
     1. Enter a **name** for the event subscription.
     1. For **Delivery mode**, select **Push**.
     1. Confirm that **Endpoint type** is set to **Event hub**.
     1. Select **Configure an endpoint**.
 
-       :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/create-subscription-page.png" alt-text="Screenshot that shows the Create Subscription page.":::              
+       :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/create-subscription-page.png" alt-text="Screenshot that shows the Create Subscription page.":::
+
     1. On the **Select Event Hub**, follow these steps:
+
         1. Select the **Azure subscription** that has the event hub.
         1. Select the **resource group** that has the event hub.
         1. Select the **Event Hubs namespace**.
         1. Select the **event hub** in the Event Hubs namespace. 
         1. Then, select **Confirm selection**.
 
-           :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/select-event-hub-page.png" alt-text="Screenshot that shows the Select event hub page.":::                    
+           :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/select-event-hub-page.png" alt-text="Screenshot that shows the Select event hub page.":::
+
     1. Back on the **Create Subscription** page, select **System Assigned** for **Managed identity type**. 
     1. Select **Create** at the bottom of the page. 
-           
-        :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/create-subscription.png" alt-text="Screenshot that shows the Create Subscription page with Create button selected.":::                    
+
+       :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/create-subscription.png" alt-text="Screenshot that shows the Create Subscription page with Create button selected.":::
 
 ## Configure routing in the Event Grid namespace
 
 1. Navigate back to the **Event Grid Namespace** page by selecting the namespace in the **Essentials** section of the **Event Grid Namespace Topic** page or by selecting the namespace name in the breadcrumb menu at the top. 
 1. On the **Event Grid Namespace** page, select **Routing** on the left menu in the **MQTT broker** section.
 1. On the **Routing** page, select **Enable routing**.
 1. For **Topic type**, select **Namespace topic**.
-1. For **Topic**, select the Event Grid namespace topic that you created where all MQTT messages will be routed.
+1. For **Topic**, select the Event Grid namespace topic that you created where all MQTT messages are routed.
 1. Select **Apply**.
 
    :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/routing-page.png" alt-text="Screenshot that shows the Routing page with the namespace topic selected."::: 
 
-    Check notifications to confirm that the namespace is enabled with the routing information.
+   Check notifications to confirm that the namespace is enabled with the routing information.
 
 ## Create clients, topic space, and permission bindings
+
 Follow steps in the quickstart: [Publish and subscribe on an MQTT topic](./mqtt-publish-and-subscribe-portal.md) to:
 
 1. Create a client. You can create the second client if you want to, but it's optional. 
@@ -113,14 +125,13 @@ Follow steps in the quickstart: [Publish and subscribe on an MQTT topic](./mqtt-
 1. Verify that the event hub received those messages on the **Overview** page for your Event Hubs namespace.
 
    :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/verify-incoming-messages.png" alt-text="Screenshot that shows the Overview page of the event hub with incoming message count." lightbox="./media/mqtt-routing-to-event-hubs-portal-namespace-topics/verify-incoming-messages.png"::: 
- 
 
 ## View routed MQTT messages in Event Hubs by using a Stream Analytics query
 
-Navigate to the Event Hubs instance (event hub) within your event subscription in the Azure portal. Process data from your event hub by using Stream Analytics. For more information, see [Process data from Azure Event Hubs using Stream Analytics - Azure Event Hubs | Microsoft Learn](../event-hubs/process-data-azure-stream-analytics.md). You can see the MQTT messages in the query.
+Navigate to the Event Hubs instance (event hub) within your event subscription in the Azure portal. Process data from your event hub by using Stream Analytics. For more information, see [Process data from your event hub using Azure Stream Analytics](../event-hubs/process-data-azure-stream-analytics.md). You can see the MQTT messages in the query.
 
 :::image type="content" source="./media/mqtt-routing-to-event-hubs-portal/view-data-in-event-hub-instance-using-azure-stream-analytics-query.png" alt-text="Screenshot that shows the MQTT messages data in Event Hubs by using the Stream Analytics query tool.":::
 
 ## Next steps
 
-For code samples, go to [this GitHub repository](https://github.com/Azure-Samples/MqttApplicationSamples/tree/main).
+For code samples, go to the [MqttApplicationSamples GitHub repository](https://github.com/Azure-Samples/MqttApplicationSamples/tree/main).

articles/event-hubs/includes/create-event-hub.md

@@ -11,13 +11,15 @@ ms.author: spelluru
 
 To create an event hub within the namespace, do the following actions:
 
-1. On the **Overview** page, select **+ Event hub** on the command bar. 
+1. On the **Overview** page, select **+ Event hub** on the command bar.
+
+   :::image type="content" source="./media/create-event-hub/create-event-hub4.png" alt-text="Screenshot of the selection of Add event hub button on the command bar.":::
 
-      :::image type="content" source="./media/create-event-hub/create-event-hub4.png" alt-text="Screenshot of the selection of Add event hub button on the command bar.":::
 1. Type a name for your event hub, then select **Review + create**.
 
-      :::image type="content" source="./media/create-event-hub/create-event-hub5.png" alt-text="Screenshot of the Create event hub page.":::
+   :::image type="content" source="./media/create-event-hub/create-event-hub5.png" alt-text="Screenshot of the Create event hub page.":::
+
 1. On the **Review + create** page, select **Create**. 
 1. You can check the status of the event hub creation in alerts. After the event hub is created, you see it in the list of event hubs.
 
-      :::image type="content" source="./media/create-event-hub/event-hub-created.png" alt-text="Screenshot showing the list of event hubs.":::
+   :::image type="content" source="./media/create-event-hub/event-hub-created.png" alt-text="Screenshot showing the list of event hubs.":::