Freshness.

TimShererWithAquent · TimShererWithAquent · commit 602b2fe85b5e · 2025-06-24T10:23:29.000-07:00
diff --git a/articles/event-grid/includes/enable-identity-portal.md b/articles/event-grid/includes/enable-identity-portal.md
@@ -4,22 +4,22 @@
  author: spelluru
  ms.service: azure-event-grid
  ms.topic: include
- ms.date: 02/29/2024
+ ms.date: 06/25/2025
  ms.author: spelluru
 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. Turn **on** the switch to enable a system-assigned managed identity.
-1. Select **Save** on the toolbar to save the setting.
+1. On the **Event Grid Namespace** page, under **Settings**, select **Identity**.
+1. To enable a system assigned managed identity, select **On**.
+1. Select **Save** 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":::
 
-1. Select **Yes** on the confirmation message.
+1. On the confirmation message, select **Yes**.
 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":::
 
-   Check notifications in the portal to confirm that the managed identity is enabled for the namespace.
+   Check notifications in the Azure portal to confirm that the managed identity is enabled for the namespace.
diff --git a/articles/event-grid/includes/enable-mqtt-portal.md b/articles/event-grid/includes/enable-mqtt-portal.md
@@ -4,17 +4,17 @@
  author: spelluru
  ms.service: azure-event-grid
  ms.topic: include
- ms.date: 02/29/2024
+ ms.date: 06/25/2025
  ms.author: spelluru
 ms.custom: include file
 ---
 
 ## Enable MQTT broker for the Event Grid namespace 
 
-1. On the **Event Grid Namespace** page, select **Configuration** under **Settings** on the left menu.  
-1. Select the check box next to **Enable MQTT broker**. 
-1. Select **Apply** at the bottom of the page.
+1. On the **Event Grid Namespace** page, under **Settings**, select **Configuration**.
+1. Select **Enable MQTT broker**. 
+1. Select **Apply**.
 
    :::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 Azure portal to confirm that the MQTT broker is enabled for the namespace.
diff --git a/articles/event-grid/includes/event-grid-create-namespace-portal.md b/articles/event-grid/includes/event-grid-create-namespace-portal.md
@@ -4,38 +4,37 @@
  author: spelluru
  ms.service: azure-event-grid
  ms.topic: include
- ms.date: 02/29/2024
+ ms.date: 06/25/2025
  ms.author: spelluru
 ms.custom:
   - include file
   - ignite-2023
 ---
 
 ## 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.
 
-Please follow the next sections to create, view and manage an Azure Event Grid namespace.
+A *namespace* in Azure Event Grid is a logical container for one or more topics, clients, client groups, topic spaces, and permission bindings. With an Azure Event Grid namespace, you can group together related resources and manage them as a single unit in your Azure subscription. A unique namespace allows you to have multiple resources in the same Azure region. 
 
 To create a namespace:
 
-1. Sign-in to the [Azure portal](https://portal.azure.com).
+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.":::
 
-1. On the **Event Grid Namespaces** page, select **+ Create** on the toolbar. 
+1. On the **Event Grid Namespaces** page, select **+ Create**.
 
    :::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. 
+    1. Select the Azure subscription in which 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 to create the namespace. 
+    1. Select **Review + 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 **Review + create** tab, review your settings. Then select **Create**.
 1. On the **Deployment succeeded** page, select **Go to resource** to navigate to your namespace. 
diff --git a/articles/event-grid/includes/event-grid-create-namespace-topic-portal.md b/articles/event-grid/includes/event-grid-create-namespace-topic-portal.md
@@ -4,16 +4,16 @@
  author: spelluru
  ms.service: azure-event-grid
  ms.topic: include
- ms.date: 02/29/2024
+ ms.date: 06/25/2025
  ms.author: spelluru
  ms.custom: include file
 ---
 
 ## 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.
-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.
+1. On the **Event Grid Namespace** page, under **Event broker**, select **Topics**.
+1. On the **Topics** page, select **+ Topic**.
 
    :::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":::
 
diff --git a/articles/event-grid/mqtt-routing-to-event-hubs-portal-namespace-topics.md b/articles/event-grid/mqtt-routing-to-event-hubs-portal-namespace-topics.md
@@ -1,24 +1,25 @@
 ---
-title: Use namespace topics to route MQTT messages to Event Hubs
+title: 'Tutorial: Use namespace topics to route MQTT messages to Event Hubs'
 description: 'This tutorial shows how to use namespace topics to route MQTT messages to Azure Event Hubs. You use Azure portal to do the tasks in this tutorial.'
 ms.topic: tutorial
 ms.custom:
   - build-2023
   - ignite-2023
-ms.date: 02/29/2024
+ms.date: 06/25/2025
 author: george-guirguis
 ms.author: geguirgu
 ms.subservice: mqtt
+#customer intent: As a developer working with the MQTT protocol, for instance, to support IoT, I want to route messages to Azure Event Hubs.
 ---
 
 # Tutorial: Use namespace topics to route MQTT messages to Azure Event Hubs (Azure portal)
 
-In this tutorial, you learn how to use a namespace topic to route data from MQTT clients to Azure Event Hubs. Here are the high-level steps:
+In this tutorial, you learn how to use a namespace topic to route data from MQTT clients to Azure Event Hubs.
 
 ## Prerequisites
 
 - If you don't have an Azure subscription, create an [Azure free account](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio) before you begin.
-- If you're new to Event Grid, read the [Event Grid overview](../event-grid/overview.md) before you start this tutorial.
+- If you're new to Event Grid, read the [Event Grid overview](../event-grid/overview.md) before you begin.
 - Register the Event Grid resource provider according to the steps in [Register the Event Grid resource provider](custom-event-quickstart-portal.md#register-the-event-grid-resource-provider).
 - Make sure that port **8883** is open in your firewall. The sample in this tutorial uses the MQTT protocol, which communicates over port 8883. This port might be blocked in some corporate and educational network environments.
 
@@ -38,12 +39,12 @@ In a separate tab of the Web browser or in a separate window, use the Azure port
 
 ## Give Event Grid namespace the access to send events to the event hub
 
-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**.
+1. On the **Event Hubs Namespace** page, select **Access control (IAM)**.
+1. On the **Access control** page, select **+ Add**, 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.":::
 
-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.
+1. On the **Add role assignment** page, from the list of roles, select **Azure Event Hubs Data Sender**, and then select **Next**.
 
    :::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.":::
 
@@ -56,55 +57,56 @@ In a separate tab of the Web browser or in a separate window, use the Azure port
 
 1. On the **Select managed identities** page, follow these steps:
 
-    1. Select your **Azure subscription**. 
+    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.
+    1. Choose **Select**.
     
        :::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 **Add role assignment** page, select **Review + assign**.
 1. On the **Review + assign** page, select **Review + assign**. 
 
 ## Create an event subscription with Event Hubs as the endpoint
 
 1. Switch to the tab of your Web browser window that has the Event Grid namespace open. 
-1. On the **Event Grid Namespace** page, select **Topics** on the left menu.
+1. On the **Event Grid Namespace** page, select **Topics**.
 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.":::
 
-1. On the **Event Grid Namespace Topic** page, select **+ Subscription** on the command bar at the top.
+1. On the **Event Grid Namespace Topic** page, select **+ Subscription**.
 
    :::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. Enter a **Name** for the event subscription.
     1. For **Delivery mode**, select **Push**.
-    1. Confirm that **Endpoint type** is set to **Event hub**.
+    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.":::
 
     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. 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.":::
 
     1. Back on the **Create Subscription** page, select **System Assigned** for **Managed identity type**. 
-    1. Select **Create** at the bottom of the page. 
+    1. Select **Create**.
 
        :::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 **Event Grid Namespace** page, under **MQTT broker**, select **Routing**.
 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 are routed.
@@ -116,7 +118,7 @@ In a separate tab of the Web browser or in a separate window, use the Azure port
 
 ## 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:
+Follow steps in this 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. 
 1. Create a topic space.
@@ -128,10 +130,10 @@ Follow steps in the quickstart: [Publish and subscribe on an MQTT topic](./mqtt-
 
 ## 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 your event hub using Azure Stream Analytics](../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) in 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
+## Next step
 
 For code samples, go to the [MqttApplicationSamples GitHub repository](https://github.com/Azure-Samples/MqttApplicationSamples/tree/main).
diff --git a/articles/event-hubs/includes/create-event-hub.md b/articles/event-hubs/includes/create-event-hub.md
@@ -3,15 +3,15 @@ title: Create an Azure event hub (portal)
 description: This article shows you how to create an event hub in an Event Hubs namespace in the Azure portal. 
 author: spelluru
 ms.topic: include
-ms.date: 02/29/2024
+ms.date: 06/25/2025
 ms.author: spelluru
 ---
 
 ## Create an event hub
 
 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**.
 
    :::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.":::
 
diff --git a/articles/event-hubs/includes/create-event-hubs-namespace.md b/articles/event-hubs/includes/create-event-hubs-namespace.md
@@ -4,13 +4,13 @@ description: This article shows you how to create an Event Hubs namespace in the
 author: spelluru
 ms.service: azure-event-hubs
 ms.topic: include
-ms.date: 02/29/2024
+ms.date: 06/25/2025
 ms.author: spelluru
 ---
 
 ## Create an Event Hubs namespace
 
-An Event Hubs namespace provides a unique scoping container, in which you create one or more event hubs. To create a namespace in your resource group using the portal, do the following actions:
+An Event Hubs namespace provides a unique scoping container in which you create event hubs. To create a namespace in your resource group using the portal:
 
 1. In the Azure portal, from the flyout menu, select **All services**. In the **All services** page, search for and select **Event Hubs**.
 
@@ -26,13 +26,18 @@ An Event Hubs namespace provides a unique scoping container, in which you create
    1. Select the **Resource group** you created in the previous step.
    1. Enter a name for the namespace. The system immediately checks to see if the name is available.
    1. Select a **Region** for the namespace.
-   1. Choose **Basic** for the **pricing tier**. If you plan to use the namespace from **Apache Kafka** apps, use the **Standard** tier. The basic tier doesn't support Apache Kafka workloads. To learn about differences between tiers, see [Quotas and limits](../event-hubs-quotas.md), [Event Hubs Premium](../event-hubs-premium-overview.md), and [Event Hubs Dedicated](../event-hubs-dedicated-overview.md) articles. 
-   1. Leave the **throughput units** (for standard tier) or **processing units** (for premium tier) settings as it is. To learn about throughput units or processing units: [Event Hubs scalability](../event-hubs-scalability.md).
-   1. Select **Review + Create** at the bottom of the page.
+   1. For the pricing tier, choose **Basic**.
+   
+      > [!NOTE]
+      > If you plan to use the namespace from **Apache Kafka** apps, use the **Standard** tier. The basic tier doesn't support Apache Kafka workloads. To learn about differences between tiers, see [Quotas and limits](../event-hubs-quotas.md), [Event Hubs Premium](../event-hubs-premium-overview.md), and [Event Hubs Dedicated](../event-hubs-dedicated-overview.md) articles. 
+
+   1. Leave the **throughput units** (for standard tier) or **processing units** (for premium tier) settings as it is. To learn about throughput units or processing units, see [Event Hubs scalability](../event-hubs-scalability.md).
+   1. Select **Review + Create**.
 
       :::image type="content" source="./media/create-event-hubs-namespace/create-event-hub1.png" alt-text="Screenshot of the Create Namespace page in the Azure portal.":::
 
    1. On the **Review + Create** page, review the settings, and select **Create**. Wait for the deployment to complete.
+
 1. On the **Deployment** page, select **Go to resource** to navigate to the page for your namespace. 
 
    :::image type="content" source="./media/create-event-hubs-namespace/deployment-complete.png" alt-text="Screenshot of the Deployment complete page with the link to resource.":::
