Made edits per Acrolinx's suggestions

Author: kevinguo-ed

articles/azure-web-pubsub/howto-mqtt-pubsub-among-mqtt-clients.md

@@ -1,5 +1,5 @@
 ---
-title: PubSub among MQTT clients
+title: PubSub among MQTT web clients
 titleSuffix: Azure Web PubSub
 description: A how-to guide that shows to how to subscribe to messages on a topic and send messages to a topic without the involvement of a typical application server
 author: Y-Sindo
@@ -8,7 +8,7 @@ ms.service: azure-web-pubsub
 ms.topic: how-to
 ms.date: 10/17/2024
 ---
-# Publish/subscribe among MQTT clients
+# Publish/subscribe among MQTT web clients
 :::image type="content" source="media/quickstarts-pubsub-among-clients/among-clients.gif" alt-text="GIF of pub/sub among clients without an application server.":::
 
 This quickstart guide demonstrates how to
@@ -18,9 +18,9 @@ This quickstart guide demonstrates how to
 > * **publish** messages to a topic
 
 ## Prerequisites
-- A Web PubSub resource. If you haven't created one, you can follow the guidance: [Create a Web PubSub resource](./howto-develop-create-instance.md)
+- A Web PubSub resource. To created one, you can follow the guidance: [Create a Web PubSub resource](./howto-develop-create-instance.md)
 - A code editor, such as Visual Studio Code
-- Install the dependencies for the language you plan to use
+- Dependencies for the language you plan to use
 
 > [!NOTE]
 > Except for the MQTT client libraries mentioned belows, you can choose any standard MQTT client libraries that meet the following requirements to connect to Web PubSub:
@@ -209,7 +209,7 @@ client.loop_forever()
 ---
 
 ## Publish a message to a group
-In the previous step, we've set up everything needed to receive messages from `group1`, now we send messages to that group.
+In the previous step, we set up everything needed to receive messages from `group1`, now we send messages to that group.
 
 # [JavaScript](#tab/javascript)
 

articles/azure-web-pubsub/overview-mqtt.md

@@ -8,21 +8,20 @@ ms.date: 10/17/2024
 ms.service: azure-web-pubsub
 ms.topic: overview
 ---
-# Overview: MQTT in Azure Web PubSub service (Preview)
+# MQTT in Azure Web PubSub service (Preview)
 
 > [!NOTE]
 > MQTT support in Azure Web PubSub is in preview stage.
 
+## Overview
 [MQTT](https://mqtt.org/) is a lightweight pub/sub messaging protocol designed for devices with constrained resources. Azure Web PubSub service now natively supports MQTT over WebSocket transport, enabling cross-communication between MQTT web clients and other Web PubSub clients
 
 This new capability addresses two key use cases: 
-
 1. Real-time applications with mixed protocols: You can allow clients using different protocols to exchange data in real-time through Azure Web PubSub service. 
 
-2. Support for additional programming languages: You can use any MQTT library to connect with the service, making it possible to integrate with applications written in languages like C++, beyond the available SDKs in C#, JavaScript, Python, and Java. 
-
-It’s important to note that this MQTT support is a lightweight adaptation of the MQTT protocol and extends only to the features already supported by Azure Web PubSub. Some MQTT features that are not supported include: 
+2. Support for more programming languages: You can use any MQTT library to connect with the service, making it possible to integrate with applications written in languages like C++, beyond the available SDKs in C#, JavaScript, Python, and Java. 
 
+It’s important to note that this MQTT support is a lightweight adaptation of the MQTT protocol and extends only to the features already supported by Azure Web PubSub. Some MQTT features that aren't supported include: 
 - Wildcard subscriptions 
 - Retained messages 
 - Shared subscriptions 
@@ -42,14 +41,14 @@ For a more comprehensive MQTT broker solution on Azure, we recommend exploring [
 > [!NOTE]
 > This section assumes you have basic knowledge about MQTT protocols and Azure Web PubSub. 
 
-Azure Web PubSub service now recognizes MQTT messages and translates them to its native protocols. The following table shows similar or equivalent term mappings between MQTT and Web PubSub. It helps you understand how we adapt MQTT concepts into the concepts found in Web PubSub It's essential if you want to use the [data-plane REST API](./reference-rest-api-data-plane.md) or [client event handlers](./howto-develop-eventhandler.md) to interact with MQTT clients.
+Azure Web PubSub service now recognizes MQTT messages and translates them to its native protocols. The following table shows similar or equivalent term mappings between MQTT and Web PubSub. It helps you understand how we adapt MQTT concepts into those found in Web PubSub. It's essential if you want to use the [data-plane REST API](./reference-rest-api-data-plane.md) or [client event handlers](./howto-develop-eventhandler.md) to interact with MQTT web clients.
 
 [!INCLUDE [MQTT-Term-Mappings](includes/mqtt-term-mappings.md)]
 
 ## Next step
 
-> [!div class="nextstepaction"]
-> [Quickstart: Pub/Sub among MQTT clients](./quickstarts-pubsub-among-mqtt-clients.md)
-
 > [!div class="nextstepaction"]
 > [How To Connect MQTT Clients to Web PubSub](./howto-connect-mqtt-websocket-client.md)
+> [!div class="nextstepaction"]
+> [Quickstart: Pub/Sub among MQTT clients](./howto-mqtt-pubsub-among-mqtt-clients.md)
+

articles/azure-web-pubsub/reference-mqtt-support-status.md

@@ -10,26 +10,24 @@ ms.topic: reference
 ---
 # MQTT feature support status in Azure Web PubSub service
 
-Azure Web PubSub service supports MQTT protocol by translateing MQTT messages into its native protocol, enabling cross-communication between MQTT web clients and other Web PubSub clients. Since the MQTT support is a lightweight adaptation of the MQTT protocol, it extends only to the features already supported by Azure Web PubSub service. Refer to the list below for what's supported and not supported.
+Azure Web PubSub service supports MQTT protocol by translating MQTT messages into its native protocol, enabling cross-communication between MQTT web clients and other Web PubSub clients. Since the MQTT support is a lightweight adaptation of the MQTT protocol, it extends only to the features already supported by Azure Web PubSub service. Refer to the list for what's supported and not supported.
 
 ## Feature support for MQTT version 3.1.1 and 5.0
 Azure Web PubSub support MQTT protocol version 3.1.1 and 5.0. The supported features include but not limited to:
 
 - All the levels of Quality Of Service including at most once, at least once and exactly once.
-- Persistent session. MQTT sessions are preserved for up to 30 seconds when client connections are interrupted and restored when the client re-establishes a connection with the service. Note that beyond 30 seconds, the service makes no guarantee that the session is restored. 
+- Persistent session. MQTT sessions are preserved for up to 30 seconds when client connections are interrupted and restored when the client re-establishes a connection with the service. Beyond 30 seconds, the service makes no guarantee that the disrupted session is restored. 
 - Last will & testament
 - Client certificate authentication
 
-## Additional features supported for MQTT 5.0
-
+## More features supported for MQTT 5.0
 - Message expiry interval and session expiry interval
 - Subscription identifier
 - Assigned client ID
 - Flow control
 - Server-sent disconnect
 
 ## Not supported features
-
 - Wildcard subscription
 - Retained messages
 - Topic alias

articles/azure-web-pubsub/toc.yml

@@ -146,7 +146,7 @@
     - name: Overview
       href: overview-mqtt.md
     - name: Quickstart for MQTT users
-      href: quickstarts-pubsub-among-mqtt-clients.md
+      href: howto-mqtt-pubsub-among-mqtt-clients.md
     - name: Tutorials
       expanded: true
       items: