Freshness review

Author: PatAltimore

articles/iot-operations/create-edge-apps/howto-develop-mqttnet-apps.md

@@ -1,25 +1,25 @@
 ---
-title: Use MQTTnet to develop distributed application workloads
-description: Develop distributed applications that talk with MQTT broker using MQTTnet.
+title: Develop distributed application workloads with MQTTnet
+description: Learn how to develop distributed applications using MQTTnet to connect with MQTT broker.
 author: PatAltimore
 ms.author: patricka
 ms.subservice: azure-mqtt-broker
 ms.topic: how-to
 ms.custom:
   - ignite-2023
-ms.date: 10/22/2024
+ms.date: 05/07/2025
 
 #CustomerIntent: As an developer, I want to understand how to use MQTTnet to develop distributed apps that talk with MQTT broker.
 ms.service: azure-iot-operations
 ---
 
-# Use MQTTnet to develop distributed application workloads that connect to MQTT broker
+# Develop distributed application workloads with MQTTnet
 
-[MQTTnet](https://dotnet.github.io/MQTTnet/) is an open-source, high performance .NET library for MQTT based communication. This article uses a Kubernetes service account token and MQTTnet to connect to MQTT broker. You should use service account tokens to connect in-cluster applications.
+[MQTTnet](https://dotnet.github.io/MQTTnet/) is an open-source, high performance .NET library for MQTT based communication. This article explains how to use a Kubernetes service account token and MQTTnet to connect to MQTT broker. Use service account tokens to connect in-cluster applications.
 
 ## Sample code
 
-The [sample code](https://github.com/Azure-Samples/explore-iot-operations/tree/main/samples/mqtt-client-dotnet/Program.cs) performs the following steps:
+The [sample code](https://github.com/Azure-Samples/explore-iot-operations/tree/main/samples/mqtt-client-dotnet/Program.cs) does the following:
 
 1. Creates an MQTT client using the `MqttFactory` class:
 
@@ -28,16 +28,16 @@ The [sample code](https://github.com/Azure-Samples/explore-iot-operations/tree/m
     var mqttClient = mqttFactory.CreateMqttClient();
     ```
 
-1. The [Kubernetes pod specification](#pod-specification) mounts the service account on the container file system. The contents of the file are read:
-##3. The mounted token is used as the password with well-known username `K8S-SAT`:
+1. The [Kubernetes pod specification](#pod-specification) mounts the service account on the container file system, and the file contents are read:
+##3. The mounted token is used as the password with the well known username `K8S-SAT`:
 
     ```csharp
     static string sat_auth_file = "/var/run/secrets/tokens/mqtt-client-token";
     ...
     var satToken = File.ReadAllBytes(sat_auth_file);
     ```
 
-1. The MQTT client options are configured using the `MqttClientOptions` class. Using the `MqttClientOptionsBuilder` as advised in the [client](https://github.com/dotnet/MQTTnet/wiki/Client) documentation is the advised way of setting the options:
+1. The MQTT client options are configured using the `MqttClientOptions` class. The `MqttClientOptionsBuilder`, as recommended in the [client](https://github.com/dotnet/MQTTnet/wiki/Client) documentation, is the preferred way to set the options:
 
     ```csharp
     var mqttClientOptions = new MqttClientOptionsBuilder()
@@ -53,7 +53,7 @@ The [sample code](https://github.com/Azure-Samples/explore-iot-operations/tree/m
     var response = await mqttClient.ConnectAsync(mqttClientOptions.Build(), CancellationToken.None);
     ```
 
-6. MQTT messages can be created using the properties directly or using `MqttApplicationMessageBuilder`. This class has overloads that allow dealing with different payload formats. The API of the builder is a fluent API. The following code shows how to compose an application message and publish them to an article called *sampletopic*:
+1. Create MQTT messages using properties directly or with `MqttApplicationMessageBuilder`. This class provides overloads for handling different payload formats. The builder API uses a fluent design. The following code shows how to compose an application message and publish it to a topic called *sampletopic*:
 
     ```csharp
     var applicationMessage = new MqttApplicationMessageBuilder()
@@ -66,7 +66,7 @@ The [sample code](https://github.com/Azure-Samples/explore-iot-operations/tree/m
 
 ## Pod specification
 
-The `serviceAccountName` field in the pod configuration must match the service account associated with the token being used. Also, note the `serviceAccountToken.expirationSeconds` is set to **86400 seconds**, and once it expires, you need to reload the token from disk. This logic isn't implemented in this sample.
+The `serviceAccountName` field in the pod configuration must match the service account associated with the token being used. Also, note that the `serviceAccountToken.expirationSeconds` is set to **86400 seconds**, and when it expires, you need to reload the token from disk. This logic isn't implemented in this sample.
 
 ```yaml
 apiVersion: v1
@@ -86,7 +86,7 @@ spec:
 
   volumes:
 
-  # SAT token used to authenticate between the application and the MQTT broker  
+  # The SAT token authenticates the application with the MQTT broker  
   - name: mqtt-client-token
     projected:
       sources:
@@ -121,7 +121,7 @@ spec:
       value: "/var/run/secrets/tokens/mqtt-client-token"
 ```
 
-To run the sample, follow the instructions in its [README](https://github.com/Azure-Samples/explore-iot-operations/tree/main/samples/mqtt-client-dotnet).
+Run the sample by following the instructions in its [README](https://github.com/Azure-Samples/explore-iot-operations/tree/main/samples/mqtt-client-dotnet).
 
 ## Related content