Edits

Author: gsteve88

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

@@ -158,8 +158,6 @@ To invoke a direct method on a device through IoT Hub, your service needs the **
 
 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).
 
-[!INCLUDE [iot-authentication-service-connection-string.md](iot-authentication-service-connection-string.md)]
-
 ```csharp
 ServiceClient serviceClient;
 string connectionString = "{IoT hub service shared access policy connection string}";
@@ -177,10 +175,10 @@ 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](#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 listener](#create-a-direct-method-callback-listener) section of this article.
 
 ```csharp
-static string targetDevice = "myDeviceId";
+string targetDevice = "myDeviceId";
 CloudToDeviceMethod method = new CloudToDeviceMethod("reboot");
 method.ResponseTimeout = TimeSpan.FromSeconds(30);
 

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

@@ -25,10 +25,16 @@ This section describes how to use device application code to create a direct met
 
 ### Device import statement
 
-Use the following device import statement to access the Azure IoT SDK for Java.
+Use the following device import statements to access the Azure IoT SDK for Java.
 
 ```java
 import com.microsoft.azure.sdk.iot.device.*;
+import com.microsoft.azure.sdk.iot.device.exceptions.IotHubClientException;
+import com.microsoft.azure.sdk.iot.device.twin.DirectMethodPayload;
+import com.microsoft.azure.sdk.iot.device.twin.DirectMethodResponse;
+import com.microsoft.azure.sdk.iot.device.twin.MethodCallback;
+import com.microsoft.azure.sdk.iot.device.transport.IotHubConnectionStatus;
+import com.microsoft.azure.sdk.iot.device.twin.SubscriptionAcknowledgedCallback;
 ```
 
 ### Connect to a device
@@ -60,6 +66,8 @@ To connect to a device:
 
 Use [subscribeToMethods](https://azure.github.io/azure-iot-sdk-java/master/device/com/microsoft/azure/sdk/iot/device/InternalClient.html#subscribeToMethods-com.microsoft.azure.sdk.iot.device.twin.MethodCallback-java.lang.Object-int-) to initialize a direct method callback listener. `subscribeToMethods` listens for incoming direct methods until the connection is terminated. The method name and payload is received for each direct method call.
 
+The listener should call [DirectMethodResponse](/java/api/com.microsoft.azure.sdk.iot.device.twin.directmethodresponse) to send a method response acknowledgment to the calling application.
+
 For example:
 
 ```java

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

@@ -11,7 +11,7 @@ ms.date: 11/25/2024
 ms.custom: mqtt, devx-track-js
 ---
 
-  *  Requires Node.js version 10.0.x or later.
+  *  Requires Node.js version 10.0.x or later
 
 ## Overview
 
@@ -111,7 +111,7 @@ This example sets up a direct method handler named `onReboot` that is called whe
 client.onDeviceMethod('reboot', onReboot);
 ```
 
-In this example, the `onReboot` callback method implements the direct method on the device. The code is executed when the "reboot" direct method is called from a service application.
+In this example, the `onReboot` callback method implements the direct method on the device. The code is executed when the "reboot" direct method is called from a service application. The function calls `send` to send a response acknowledgment message to the calling application.
 
 ```javascript
 var onReboot = function(request, response) {

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

@@ -63,7 +63,7 @@ device_client = IoTHubDeviceClient.create_from_connection_string(conn_str)
 
 Use [on_method_request_received](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#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.
 
-The handler function should call [MethodResponse](/python/api/azure-iot-device/azure.iot.device.methodresponse) to send a response acknowledgment to the calling application.
+The handler function should create a [MethodResponse](/python/api/azure-iot-device/azure.iot.device.methodresponse) and pass it to [send_method_response](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-send-method-response) to send a direct method response acknowledgment to the calling application.
 
 This example sets up a direct method handler named `method_request_handler`.
 
@@ -76,7 +76,7 @@ except:
     client.shutdown()
 ```
 
-In this example, the `method_request_handler` callback method implements the direct method on the device. The code is executed when the "rebootDevice" direct method is called from a service application. The method calls `MethodResponse` to send a response acknowledgment to the calling application.
+In this example, the `method_request_handler` callback method implements the direct method on the device. The code is executed when the "rebootDevice" direct method is called from a service application. The method calls `send_method_response` to send a direct method response acknowledgment to the calling application.
 
 ```python
 # Define the handler for method requests
@@ -189,4 +189,7 @@ except Exception as ex:
 
 ### SDK service samples
 
-The Azure IoT SDK for Python provides a working sample of a service app that handles direct method tasks. For more information, see [Service helper sync](https://github.com/Azure/azure-iot-sdk-python/blob/e75d1c2026eab939d5d31097fd0c22924c53abf8/dev_utils/dev_utils/service_helper_sync.py).
+The Azure IoT SDK for Python provides working samples of service apps that handle direct method tasks. For more information, see:
+
+* [Service helper sync](https://github.com/Azure/azure-iot-sdk-python/blob/e75d1c2026eab939d5d31097fd0c22924c53abf8/dev_utils/dev_utils/service_helper_sync.py)
+* [Service operations](https://github.com/Azure/azure-iot-sdk-python/blob/e75d1c2026eab939d5d31097fd0c22924c53abf8/tests/e2e/provisioning_e2e/iothubservice20180630/operations/service_operations.py)