Merge pull request #233859 from yoninalmsft/patch-57

Update tutorial-create-micro-agent-module-twin.md

Author: ttorble

articles/defender-for-iot/device-builders/tutorial-create-micro-agent-module-twin.md

@@ -12,18 +12,6 @@ This tutorial will help you learn how to create an individual `DefenderIotMicroA
 
 ## Device twins
 
-For IoT solutions built in Azure, device twins play a key role in both device management and process automation.
-
-Defender for IoT fully integrates with your existing IoT device management platform. Full integration, enables you to manage your device's security status, and allows you to make use of all existing device control capabilities. Integration is achieved by making use of the IoT Hub twin mechanism.
-
-Learn more about the concept of [Understand and use device twins in IoT Hub](../../iot-hub/iot-hub-devguide-device-twins.md).
-
-## Defender-IoT-micro-agent twin
-
-Defender for IoT uses a Defender-IoT-micro-agent twin for each device. The Defender-IoT-micro-agent twin holds all of the information that is relevant to device security, for each specific device in your solution. Device security properties are configured through a dedicated Defender-IoT-micro-agent twin for safer communication, to enable updates, and maintenance that requires fewer resources.
-
-## Understanding DefenderIotMicroAgent module twins
-
 Device twins play a key role in both device management and process automation, for IoT solutions that are built in to Azure.
 
 Defender for IoT offers the capability to fully integrate your existing IoT device management platform, enabling you to manage your device security status and make use of the existing device control capabilities. You can integrate your Defender for IoT by using the IoT Hub twin mechanism.  
@@ -32,7 +20,11 @@ To learn more about the general concept of module twins in Azure IoT Hub, see [U
 
 Defender for IoT uses the module twin mechanism, and maintains a Defender-IoT-micro-agent twin named `DefenderIotMicroAgent` for each of your devices.
 
-To take full advantage of all Defender for IoT feature's, you need to create, configure, and use the Defender-IoT-micro-agent twins for every device in the service.
+To take full advantage of all Defender for IoT features, you need to create, configure, and use the Defender-IoT-micro-agent twins for every device in the service.
+
+## Defender-IoT-micro-agent twin
+
+Defender for IoT uses a Defender-IoT-micro-agent twin for each device. The Defender-IoT-micro-agent twin holds all of the information that is relevant to device security for each specific device in your solution. Device security properties are configured through a dedicated Defender-IoT-micro-agent twin for safer communication, to enable updates, and maintenance that requires fewer resources.
 
 In this tutorial you'll learn how to:
 
@@ -50,7 +42,7 @@ In this tutorial you'll learn how to:
 
 - You must have [enabled Microsoft Defender for IoT on your Azure IoT Hub](quickstart-onboard-iot-hub.md).
 
-- You must have [added a resource group to your IoT solution](quickstart-configure-your-solution.md)
+- You must have [added a resource group to your IoT solution](quickstart-configure-your-solution.md).
 
 ## Create a DefenderIotMicroAgent module twin
 
@@ -66,7 +58,7 @@ A `DefenderIotMicroAgent` module twin can be created by manually editing each mo
 
 1. Select **Add module identity**.
 
-1. In the Module Identity Name field, enter `DefenderIotMicroAgent`.
+1. In the **Module Identity Name** field, enter `DefenderIotMicroAgent`.
 
 1. Select **Save**.
 
@@ -80,7 +72,7 @@ A `DefenderIotMicroAgent` module twin can be created by manually editing each mo
 
 1. Select your device.
 
-1. Under the Module identities menu, confirm the existence of the `DefenderIotMicroAgent` module in the list of module identities associated with the device.  
+1. Under the **Module Identities** tab, confirm the existence of the `DefenderIotMicroAgent` module in the list of module identities associated with the device.  
 
     :::image type="content" source="media/quickstart-create-micro-agent-module-twin/device-details-module.png" alt-text="Select module identities from the tab.":::