Edits

Author: gsteve88

articles/iot-hub/how-to-device-management.md

@@ -47,6 +47,19 @@ This article shows you how to develop two types of applications:
 * 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.
 

includes/iot-hub-howto-device-management-python.md

@@ -25,6 +25,16 @@ This section describes how to use device application code to:
 
 [!INCLUDE [iot-authentication-device-connection-string.md](iot-authentication-device-connection-string.md)]
 
+### Import statements
+
+These import statements are required by `IoTHubDeviceClient`.
+
+```python
+# import the device client library
+import asyncio
+from azure.iot.device.aio import IoTHubDeviceClient
+```
+
 ### Connect to a device
 
 The [IoTHubDeviceClient](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient) class contains methods that can be used to work with direct methods.
@@ -34,10 +44,6 @@ To connect an application to a device:
 1. Call [connect](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-connect) to connect the device client to an Azure IoT hub
 
 ```python
-# import the device client library
-import asyncio
-from azure.iot.device.aio import IoTHubDeviceClient
-
 # substitute the device connection string in conn_str
 # and add it to the IoTHubDeviceClient object
 conn_str = "{IOT hub device connection string}"
@@ -49,7 +55,7 @@ await device_client.connect()
 
 ### Create a direct method callback
 
-Call [on_method_request_received](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?&#azure-iot-device-iothubdeviceclient-on-twin-desired-properties-patch-received) to create a handler function or coroutine that is called when a direct method is received. The listener is associated with a method name keyword, such as "reboot". The method name can be used in an IoT Hub or backend application to trigger the callback method on the device.
+Call [on_method_request_received](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?view=azure-python&branch=main#azure-iot-device-iothubdeviceclient-on-method-request-received) to create a handler function or coroutine that is called when a direct method is received. The listener is associated with a method name keyword, such as "reboot". The method name can be used in an IoT Hub or backend application to trigger the callback method on the device.
 
 This example sets up a desired properties patch handler named `method_request_handler`.
 
@@ -66,7 +72,7 @@ except:
 
 In this example, the `method_request_handler` 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.
 
-This example sets up a callback listener named `method_request_handler` that will trigger when the "rebootDevice" direct method name is called.
+This example sets up a callback listener named `method_request_handler` that triggers when the "rebootDevice" direct method is called from a service application.
 
 ```python
 # Define the handler for method requests
@@ -104,13 +110,13 @@ The Azure IoT SDK for Python provides a working sample of a device app that hand
 
 ## Create a backend application
 
-This section describes how to initiate a remote reboot on a device using a direct method.
+This section describes how to initiate a remote reboot on a device using a direct method call from a backend service application.
 
 The [IoTHubRegistryManager](/python/api/azure-iot-hub/azure.iot.hub.iothubregistrymanager) class exposes all methods required to create a backend application to send messages to a device.
 
 ### Import statements
 
-Add these import statements to connect to Iot Hub, receive cloud-to-device methods, and call twin methods.
+Add these import statements to connect to Iot Hub, receive cloud-to-device methods, and call device twin methods.
 
 ```python
 import sys, time
@@ -125,7 +131,7 @@ Connect to IoT hub using [from_connection_string](/python/api/azure-iot-hub/azur
 
 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.
 
-As a parameter to `CreateFromConnectionString`, supply the **service** shared access policy. For more information about shared access policies, see [Control access to IoT Hub with shared access signatures](/azure/iot-hub/authenticate-authorize-sas).
+As a parameter to `CreateFromConnectionString`, supply the **service** shared access policy connection string. For more information about shared access policies, see [Control access to IoT Hub with shared access signatures](/azure/iot-hub/authenticate-authorize-sas).
 
 For example:
 
@@ -137,14 +143,14 @@ iothub_registry_manager = IoTHubRegistryManager.from_connection_string(IOTHUB_CO
 
 ### Invoke a method on a device
 
-You can invoke a direct method on a device. The method name is mapped to a name, which is "rebootTime" in the examples within this article.
+You can invoke a direct method by name on a device. The method name identifies the method. The method name is "rebootTime" in the examples within this article.
 
 To invoke a direct method on a device:
 
 1. Create a [CloudToDeviceMethod](/python/api/azure-iot-hub/azure.iot.hub.protocol.models.cloudtodevicemethod) object. Supply the method name and payload as parameters.
 1. Call [invoke_device_method](/python/api/azure-iot-hub/azure.iot.hub.iothub_registry_manager.iothubregistrymanager?#azure-iot-hub-iothub-registry-manager-iothubregistrymanager-invoke-device-method) to invoke a direct method on a device. Supply the device ID and `CloudToDeviceMethod` payload object as parameters.
 
-This example invokes a direct method named "rebootDevice" on a device. The example then uses device twin queries to discover the last reboot time for the device that was updated in the **Create a direct method callback** section of this article.
+This example invokes a direct method named "rebootDevice" on a device. The example then uses device twin queries to discover the last reboot time for the device that was updated as described in the **Create a direct method callback** section of this article.
 
 ```python
 CONNECTION_STRING = "{IoTHubConnectionString}"