Edits

Author: gsteve88

includes/iot-hub-howto-auth-device-cert-python.md

@@ -14,7 +14,6 @@ ms.date: 12/06/2024
 To connect a device to IoT Hub using an X.509 certificate:
 
 1. Use [create_from_x509_certificate](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-create-from-x509-certificate) to add the X.509 certificate parameters
-
 1. Call [connect](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-connect) to connect the device client
 
 This example shows certificate input parameter values as local variables for clarity. In a production system, store sensitive input parameters in environment variables or another more secure storage location. For example, use `os.getenv("HOSTNAME")` to read the host name environment variable.

includes/iot-hub-howto-file-upload-dotnet.md

@@ -181,3 +181,7 @@ while (true)
     await notificationReceiver.CompleteAsync(fileUploadNotification);
 }
 ```
+
+### SDK file upload receiver sample
+
+The SDK includes this [file upload receiver sample](https://github.com/Azure/azure-iot-sdk-csharp/blob/86065001a92fedb42877722c6a57ae37e45eed30/iothub/service/samples/getting%20started/FileUploadNotificationReceiverSample/FileUploadNotificationReceiverSample.cs).

includes/iot-hub-howto-file-upload-java.md

@@ -24,19 +24,11 @@ This section describes how to upload a file from a device to an IoT hub using th
 
 Follow this procedure to upload a file from a device to IoT hub:
 
-1. Connect to the device
+1. Connect the device to IoT Hub
 1. Get a SAS URI from IoT hub
 1. Upload the file to Azure Storage
 1. Send file upload status notification to IoT hub
 
-### Connection protocol
-
-File upload operations always use HTTPS, but [DeviceClient](/java/api/com.microsoft.azure.sdk.iot.device.deviceclient) can define the [IotHubClientProtocol](/java/api/com.microsoft.azure.sdk.iot.device.iothubclientprotocol) for other services like telemetry, device method, and device twin.
-
-```java
-IotHubClientProtocol protocol = IotHubClientProtocol.MQTT;
-```
-
 ### Connect a device to IoT Hub
 
 A device app can authenticate with IoT Hub using the following methods:
@@ -50,6 +42,12 @@ A device app can authenticate with IoT Hub using the following methods:
 
 #### Authenticate using a shared access key
 
+File upload operations always use HTTPS, but [DeviceClient](/java/api/com.microsoft.azure.sdk.iot.device.deviceclient) can define the [IotHubClientProtocol](/java/api/com.microsoft.azure.sdk.iot.device.iothubclientprotocol) for other services like telemetry, device method, and device twin.
+
+```java
+IotHubClientProtocol protocol = IotHubClientProtocol.MQTT;
+```
+
 Instantiate the `DeviceClient` to connect to the device using the device primary connection string.
 
 ```java
@@ -165,7 +163,7 @@ private static final IotHubServiceClientProtocol protocol =
 
 Create the [ServiceClient](/java/api/com.azure.core.annotation.serviceclient) object, supplying the Iot Hub connection string and protocol.
 
-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.
+To upload a file on a device to 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 the `ServiceClient` constructor, 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).
 

includes/iot-hub-howto-file-upload-python.md

@@ -29,13 +29,6 @@ pip install azure.storage.blob
 
 This section describes how to upload a file from a device to an IoT hub using the [IoTHubDeviceClient](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient) class from the Azure IoT SDK for Python.
 
-Follow this procedure to upload a file from a device to IoT hub:
-
-1. Connect to the device
-1. Get Blob Storage information
-1. Upload the file to Blob Storage
-1. Notify IoT hub of upload status
-
 ### Import libraries
 
 ```python
@@ -60,8 +53,7 @@ A device app can authenticate with IoT Hub using the following methods:
 
 To connect a device to IoT Hub:
 
-1. Call [create_from_connection_string](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-create-from-connection-string) to add the device primary connection string
-
+1. Call [create_from_connection_string](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-create-from-connection-string) to add the device primary connection string.
 1. Call [connect](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-connect) to connect the device client
 
 For example: