Edits

Author: gsteve88

includes/iot-hub-howto-cloud-to-device-messaging-dotnet.md

@@ -17,8 +17,6 @@ There are two options that a device client application can use to receive messag
 * **Callback**: The device application sets up an asynchronous message handler method that is called immediately when a message arrives.
 * **Polling**: The device application checks for new IoT Hub messages using a code loop (for example, a `while` or `for` loop). The loop executes continually, checking for messages.
 
-[!INCLUDE [iot-authentication-device-connection-string.md](iot-authentication-device-connection-string.md)]
-
 ### Required device NuGet Package
 
 Device client applications written in C# require the **Microsoft.Azure.Devices.Client** NuGet package.
@@ -34,12 +32,10 @@ using Microsoft.Azure.Devices.Shared;
 
 A device app can authenticate with IoT Hub using the following methods:
 
-* X.509 certificate
 * Shared access key
+* X.509 certificate
 
-#### Authenticate using an X.509 certificate
-
-[!INCLUDE [iot-hub-howto-auth-device-cert-dotnet](iot-hub-howto-auth-device-cert-dotnet.md)]
+[!INCLUDE [iot-authentication-device-connection-string.md](iot-authentication-device-connection-string.md)]
 
 #### Authenticate using a shared access key
 
@@ -62,6 +58,10 @@ deviceClient = DeviceClient.CreateFromConnectionString(DeviceConnectionString,
    TransportType.Mqtt);
 ```
 
+#### Authenticate using an X.509 certificate
+
+[!INCLUDE [iot-hub-howto-auth-device-cert-dotnet](iot-hub-howto-auth-device-cert-dotnet.md)]
+
 ### Callback
 
 To receive callback cloud-to-device messages in the device application, the application must connect to the IoT Hub and set up a callback listener to process incoming messages. Incoming messages to the device are received from the IoT Hub message queue.

includes/iot-hub-howto-cloud-to-device-messaging-java.md

@@ -8,11 +8,11 @@ ms.date: 12/19/2024
 ms.custom: [amqp, mqtt, devx-track-java, devx-track-extended-java]
 ---
 
-## Receive cloud-to-device messages on a device
+## Create a device application
 
 This section describes how to receive cloud-to-device messages using the [DeviceClient](/java/api/com.microsoft.azure.sdk.iot.device.deviceclient) class from the Azure IoT SDK for Java.
 
-For a Java-based device application to receive cloud-to-device messages, it must connect to IoT Hub, then set up a callback listener and message handler to process incoming messages from IoT Hub. The device application should also be able to detect and handle disconnects in case the device-to-IoT Hub message connection is broken.
+For a Java-based device application to receive cloud-to-device messages, it must connect to IoT Hub, then set up a callback listener and message handler to process incoming messages from IoT Hub.
 
 ### Import Azure IoT Java SDK libraries
 
@@ -31,6 +31,8 @@ A device app can authenticate with IoT Hub using the following methods:
 * X.509 certificate
 * Shared access key
 
+[!INCLUDE [iot-authentication-device-connection-string.md](iot-authentication-device-connection-string.md)]
+
 #### Authenticate using an X.509 certificate
 
 [!INCLUDE [iot-hub-howto-auth-device-cert-java](iot-hub-howto-auth-device-cert-java.md)]
@@ -157,7 +159,7 @@ client.open(true);
 
 **HandleMessages**: a sample device app included with the [Microsoft Azure IoT SDK for Java](https://github.com/Azure/azure-iot-sdk-java/tree/main/iothub/device/iot-device-samples), which connects to your IoT hub and receives cloud-to-device messages.
 
-## Send cloud-to-device messages from a backend application
+## Create a backend application
 
 This section describes how to send a cloud-to-device message using the [ServiceClient](/java/api/com.azure.core.annotation.serviceclient) class from the Azure IoT SDK for Java. A solution backend application connects to an IoT Hub and messages are sent to IoT Hub encoded with a destination device. IoT Hub stores incoming messages to its message queue, and messages are delivered from the IoT Hub message queue to the target device.
 
@@ -196,7 +198,7 @@ You can connect a backend service to IoT Hub using the following methods:
 
 #### Connect using a shared access policy
 
-#### Define the connection protocol
+##### Define the connection protocol
 
 Use [IotHubServiceClientProtocol](/java/api/com.microsoft.azure.sdk.iot.service.iothubserviceclientprotocol) to define the application-layer protocol used by the service client to communicate with an IoT Hub.
 
@@ -206,7 +208,7 @@ Use [IotHubServiceClientProtocol](/java/api/com.microsoft.azure.sdk.iot.service.
 IotHubServiceClientProtocol protocol = IotHubServiceClientProtocol.AMQPS;
 ```
 
-#### Create the ServiceClient object
+##### Create the ServiceClient object
 
 Create the [ServiceClient](/java/api/com.azure.core.annotation.serviceclient) object, supplying the Iot Hub connection string and protocol.
 
@@ -215,7 +217,7 @@ String connectionString = "{yourhubconnectionstring}";
 ServiceClient serviceClient (connectionString, protocol);
 ```
 
-### Open the connection between application and IoT Hub
+##### Open the connection between application and IoT Hub
 
 [open](/java/api/com.microsoft.azure.sdk.iot.service.serviceclient?#com-microsoft-azure-sdk-iot-service-serviceclient-open()) the AMQP sender connection. This method creates the connection between the application and IoT Hub.
 

includes/iot-hub-howto-cloud-to-device-messaging-node.md

@@ -29,6 +29,8 @@ A device app can authenticate with IoT Hub using the following methods:
 * X.509 certificate
 * Shared access key
 
+[!INCLUDE [iot-authentication-device-connection-string.md](iot-authentication-device-connection-string.md)]
+
 #### Authenticate using an X.509 certificate
 
 [!INCLUDE [iot-hub-howto-auth-device-cert-node](iot-hub-howto-auth-device-cert-node.md)]

includes/iot-hub-howto-cloud-to-device-messaging-python.md

@@ -22,7 +22,7 @@ pip install azure-iot-device
 
 For a Python-based device application to receive cloud-to-device messages, it must connect to IoT Hub and then set up a callback message handler to process incoming messages from IoT Hub.
 
-### Device import statements
+### Device import statement
 
 Add this code to import the `IoTHubDeviceClient` functions from the azure.iot.device SDK.
 
@@ -34,15 +34,11 @@ from azure.iot.device import IoTHubDeviceClient
 
 A device app can authenticate with IoT Hub using the following methods:
 
-* X.509 certificate
 * Shared access key
+* X.509 certificate
 
 [!INCLUDE [iot-authentication-device-connection-string.md](iot-authentication-device-connection-string.md)]
 
-#### Authenticate using an X.509 certificate
-
-[!INCLUDE [iot-hub-howto-auth-device-cert-python](iot-hub-howto-auth-device-cert-python.md)]
-
 #### Authenticate using a shared access key
 
 To connect a device to IoT Hub:
@@ -61,6 +57,10 @@ device_client = IoTHubDeviceClient.create_from_connection_string(CONNECTION_STRI
 device_client.connect()
 ```
 
+#### Authenticate using an X.509 certificate
+
+[!INCLUDE [iot-hub-howto-auth-device-cert-python](iot-hub-howto-auth-device-cert-python.md)]
+
 ##### Handle reconnection
 
 `IoTHubDeviceClient` will by default attempt to reestablish a dropped connection. Reconnection behavior is governed by the `IoTHubDeviceClient` [connection_retry](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-on-message-received) and `connection_retry_interval` parameters.