Integrated in review feedback

gsteve88 · gsteve88 · commit ce85fcc62606 · 2024-10-28T16:38:52.000-07:00
diff --git a/articles/iot-hub/how-to-device-management.md b/articles/iot-hub/how-to-device-management.md
@@ -24,11 +24,11 @@ The device is responsible for:
 
 * Initiating the corresponding device-specific action on the device.
 
-* Providing status updates through *reported properties* to IoT Hub.
+* Providing status updates through reported properties to IoT Hub.
 
 The back-end app can run device twin queries to report on the progress of the device management actions.
 
-This article shows you how a back-end app and a device app can work together to initiate and monitor a remote device reboot using IoT Hub:
+This article shows you how a back-end app and a device app can work together to initiate and monitor a remote device action using direct methods and device twins. For this article, we use a device reboot as an example:
 
 * A service app calls a direct method to reboot in a device app through an IoT hub. The service app then displays the response and updated reported properties.
 * A device app handles a direct method to reboot a device and updates the last reboot time.
@@ -47,23 +47,7 @@ This article shows you how a back-end app and a device app can work together to
 * If your application uses the MQTT protocol, make sure that **port 8883** is open in your firewall. The MQTT protocol communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work around this issue, see [Connecting to IoT Hub (MQTT)](../iot/iot-mqtt-connect-to-iot-hub.md#connecting-to-iot-hub).
 
 * Language SDK requirements:
-  * **.NET SDK** - Requires Visual Studio.
-  * **Python SDK** - [Python version 3.7 or later](https://www.python.org/downloads/) is recommended. Make sure to use the 32-bit or 64-bit installation as required by your setup. When prompted during the installation, make sure to add Python to your platform-specific environment variable.
 
-    * Device applications require the **azure-iot-device** package. You can install the package using this command:
-
-      ```cmd/sh
-        pip install azure-iot-device
-      ```
-
-    * Service applications require the **azure-iot-hub** package. You can install the package using this command:
-
-      ```cmd/sh
-        pip install azure-iot-hub
-      ```
-
-  * **Java** - Requires [Java SE Development Kit 8](/azure/developer/java/fundamentals/). Make sure you select **Java 8** under **Long-term support** to navigate to downloads for JDK 8.
-  * **Node.js** - Requires Node.js version 10.0.x or later.
 
 :::zone pivot="programming-language-csharp"
 
diff --git a/includes/iot-hub-howto-device-management-dotnet.md b/includes/iot-hub-howto-device-management-dotnet.md
@@ -11,6 +11,8 @@ ms.date: 10/09/2024
 ms.custom: mqtt, devx-track-csharp, devx-track-dotnet
 ---
 
+  * **.NET SDK** - Requires Visual Studio.
+
 ## Overview
 
 This article describes how to use the [Azure IoT SDK for .NET](https://github.com/Azure/azure-iot-sdk-csharp) to create device and backend service application code for device direct messages.
@@ -85,7 +87,7 @@ catch (Exception ex)
 }
 ```
 
-In this example, the `onReboot` callback method implements the direct method on the device. This code updates reported properties related to a simulated device reboot. The reported properties can be read and verified by an IoT Hub or backend application, as demonstrated in the **Create a backend application** section of this article.
+In this example, the `onReboot` callback method implements the direct method on the device. This code updates reported properties related to a device reboot. The reported properties can be read and verified by a IoT Hub or backend application, as demonstrated in the [Create a backend application](#create-a-backend-application) section of this article.
 
 ```csharp
 static Task<MethodResponse> onReboot(MethodRequest methodRequest, object userContext)
@@ -124,7 +126,7 @@ static Task<MethodResponse> onReboot(MethodRequest methodRequest, object userCon
 
 ### SDK device samples
 
-The Azure IoT SDK for .NET provides working samples of device apps that handle device message tasks. For more information, see:
+The Azure IoT SDK for .NET provides working samples of device apps that handle direct method tasks. For more information, see:
 
 * [Method Sample](https://github.com/Azure/azure-iot-sdk-csharp/tree/main/iothub/device/samples/getting%20started/MethodSample)
 * [Simulated Device with Command](https://github.com/Azure/azure-iot-sdk-csharp/tree/main/iothub/device/samples/getting%20started/SimulatedDeviceWithCommand)
@@ -133,9 +135,9 @@ The Azure IoT SDK for .NET provides working samples of device apps that handle d
 
 ## Create a backend application
 
-This section describes how to initiate a remote reboot on a device using a direct method. The app uses device twin queries to discover the last reboot time for that device.
+This section describes how to trigger a direct method on a device and then use device twin queries to monitor the status of that device.
 
-The [ServiceClient](/dotnet/api/microsoft.azure.devices.serviceclient) class exposes all methods required to create a backend application to send messages to devices.
+The [ServiceClient](/dotnet/api/microsoft.azure.devices.serviceclient) class exposes all methods required to create a backend application to send direct method calls to devices.
 
 ### Required service NuGet package
 
@@ -152,7 +154,7 @@ Add the following `using` statements.
 
 ### Connect to IoT hub
 
-Connect a backend application to a device using [CreateFromConnectionString](/dotnet/api/microsoft.azure.devices.serviceclient.createfromconnectionstring?#microsoft-azure-devices-serviceclient-createfromconnectionstring(system-string-microsoft-azure-devices-serviceclientoptions)).
+Connect a backend application using [CreateFromConnectionString](/dotnet/api/microsoft.azure.devices.serviceclient.createfromconnectionstring?#microsoft-azure-devices-serviceclient-createfromconnectionstring(system-string-microsoft-azure-devices-serviceclientoptions)).
 
 To invoke a direct method on a device through IoT Hub, your service needs the **service connect** permission. By default, every IoT Hub is created with a shared access policy named **service** that grants this permission.
 
@@ -174,7 +176,7 @@ To invoke a method on a device:
 1. Create a [CloudToDeviceMethod](/dotnet/api/microsoft.azure.devices.cloudtodevicemethod) object. Pass the device direct method name as a parameter.
 1. Call [InvokeDeviceMethodAsync](/dotnet/api/microsoft.azure.devices.serviceclient.invokedevicemethodasync?#microsoft-azure-devices-serviceclient-invokedevicemethodasync(system-string-microsoft-azure-devices-cloudtodevicemethod-system-threading-cancellationtoken)) to invoke the method on the device.
 
-This example calls the "reboot" method to initiate a reboot on the device. The "reboot" method is mapped to a listener on the device as described in the **Create a direct method callback** section of this article.
+This example calls the "reboot" method to initiate a reboot on the device. The "reboot" method is mapped to a listener on the device as described in the [Create a direct method callback](#create-a-direct-method-callback) section of this article.
 
 ```csharp
 CloudToDeviceMethod method = new CloudToDeviceMethod("reboot");
diff --git a/includes/iot-hub-howto-device-management-java.md b/includes/iot-hub-howto-device-management-java.md
@@ -11,6 +11,8 @@ ms.date: 10/09/2024
 ms.custom: amqp, mqtt, devx-track-java, devx-track-extended-java
 ---
 
+  * **Java** - Requires [Java SE Development Kit 8](/azure/developer/java/fundamentals/). Make sure you select **Java 8** under **Long-term support** to navigate to downloads for JDK 8.
+
 ## Overview
 
 This article describes how to use the [Azure IoT SDK for Java](https://github.com/Azure/azure-iot-sdk-java) to create device and backend service application code for device direct methods.
diff --git a/includes/iot-hub-howto-device-management-node.md b/includes/iot-hub-howto-device-management-node.md
@@ -11,6 +11,8 @@ ms.date: 10/09/2024
 ms.custom: mqtt, devx-track-js
 ---
 
+  * **Node.js** - Requires Node.js version 10.0.x or later.
+
 ## Overview
 
 This article describes how to use the [Azure IoT SDK for Node.js](https://github.com/Azure/azure-iot-sdk-node) to create device and backend service application code for device direct methods.
diff --git a/includes/iot-hub-howto-device-management-python.md b/includes/iot-hub-howto-device-management-python.md
@@ -11,6 +11,20 @@ ms.date: 10/09/2024
 ms.custom: mqtt, devx-track-python, py-fresh-zinc
 ---
 
+  * **Python SDK** - [Python version 3.7 or later](https://www.python.org/downloads/) is recommended. Make sure to use the 32-bit or 64-bit installation as required by your setup. When prompted during the installation, make sure to add Python to your platform-specific environment variable.
+
+    * Device applications require the **azure-iot-device** package. You can install the package using this command:
+
+      ```cmd/sh
+        pip install azure-iot-device
+      ```
+
+    * Service applications require the **azure-iot-hub** package. You can install the package using this command:
+
+      ```cmd/sh
+        pip install azure-iot-hub
+      ```
+
 ## Overview
 
 This article describes how to use the [Azure IoT SDK for Python](https://github.com/Azure/azure-iot-sdk-python) to create device and backend service application code for device direct methods.
