Edits

Author: gsteve88

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

@@ -20,6 +20,8 @@ This how-to contains two sections:
 
 ## Upload a file from a device application
 
+This section describes how to upload a file from a device to an IoT hub using the [DeviceClient](/java/api/com.microsoft.azure.sdk.iot.device.deviceclient) class from the Azure IoT SDK for Java.
+
 Follow this procedure to upload a file from a device to IoT hub:
 
 * Connect to IoT hub

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

@@ -20,6 +20,8 @@ This how-to contains two sections:
 
 ## Upload a file from a device application
 
+This section describes how to upload a file from a device to an IoT hub using the [azure-iot-device](/javascript/api/azure-iot-device) package in the Azure IoT SDK for Node.js.
+
 ### Install SDK packages
 
 Run this command to install the **azure-iot-device** device SDK, the **azure-iot-device-mqtt**, and the **@azure/storage-blob** packages: on your development machine:
@@ -134,7 +136,9 @@ To create a file upload notification application:
 
 ### Connect to the IoT hub service client
 
-Create the [ServiceClient](/javascript/api/azure-iothub/client) using [fromConnectionString](/javascript/api/azure-iothub/client?#azure-iothub-client-fromconnectionstring).
+The [ServiceClient](/javascript/api/azure-iothub/client) class contains methods that services can use to receive file upload notifications.
+
+Connect to IoT hub using [fromConnectionString](/javascript/api/azure-iothub/client?#azure-iothub-client-fromconnectionstring).
 
 ```javascript
 const Client = require('azure-iothub').Client;

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

@@ -27,6 +27,8 @@ pip install azure.storage.blob
 
 ## Upload file from a device application
 
+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:
 
 * Connect to IoT hub
@@ -123,7 +125,7 @@ Shut down the client. Once this method is called, any attempts at further client
 device_client.shutdown()
 ```
 
-### SDK file upload sample
+### SDK file upload samples
 
 The SDK includes two file upload samples: