Edits

Author: gsteve88

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

@@ -15,7 +15,7 @@ The X.509 certificate is attached to the device-to-IoT Hub connection transport.
 
 To configure a device-to-IoT Hub connection using an X.509 certificate:
 
-1. Call [fromConnectionString](/javascript/api/azure-iothub/client?#azure-iothub-client-fromconnectionstring) to add the device connection string and transport type. Add `x509=true` to the device connection string to indicate that a certificate will be added to `DeviceClientOptions`. For example: `HostName=xxxxx.azure-devices.net;DeviceId=Device-1;SharedAccessKey=xxxxxxxxxxxxx;x509=true`.
+1. Call [fromConnectionString](/javascript/api/azure-iothub/client?#azure-iothub-client-fromconnectionstring) to add the device connection string and transport type. Add `x509=true` to the device connection string to indicate that a certificate is added to `DeviceClientOptions`. For example: `HostName=xxxxx.azure-devices.net;DeviceId=Device-1;SharedAccessKey=xxxxxxxxxxxxx;x509=true`.
 1. Configure a JSON variable with certificate details and pass it to [DeviceClientOptions](/javascript/api/azure-iot-device/deviceclientoptions).
 1. Call [setOptions](/javascript/api/azure-iot-device/client?#azure-iot-device-client-setoptions-1) to add an X.509 certificate and key (and optionally, passphrase) to the client transport.
 1. Call [open](/javascript/api/azure-iothub/client?#azure-iothub-client-open) to open the connection from the device to IoT Hub.

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

@@ -31,7 +31,8 @@ The [azure-iot-device](/javascript/api/azure-iot-device) package contains object
 
 Follow this procedure to upload a file from a device to IoT hub:
 
-1. Get Blob shared access signatures
+1. Connect the device to IoT Hub
+1. Get a Blob shared access signature (SAS) token from IoT Hub
 1. Upload the file to Azure Storage
 1. Send file upload status notification to IoT hub
 
@@ -128,7 +129,7 @@ client.open(function(err) {
 })
 ```
 
-#### Get a SAS URI from IoT hub
+#### Get a SAS token from IoT hub
 
 Use [getBlobSharedAccessSignature](/javascript/api/azure-iot-device/client?#azure-iot-device-client-getblobsharedaccesssignature) to get the linked storage account SAS token from IoT hub.
 
@@ -269,7 +270,7 @@ var client = Client.fromConnectionString(connectionString);
 
 To create a file upload notification callback receiver:
 
-1. Call [getFileNotificationReceiver](/javascript/api/azure-iothub/client?#azure-iothub-client-getfilenotificationreceiver). Supply the name of a file upload callback method that are called when notification messages are received.
+1. Call [getFileNotificationReceiver](/javascript/api/azure-iothub/client?#azure-iothub-client-getfilenotificationreceiver). Supply the name of a file upload callback method that is called when notification messages are received.
 1. Process file upload notifications in the callback method.
 
 This example sets up a `receiveFileUploadNotification` notification  callback receiver. The receiver interprets the file upload status information and prints a status message to the console.

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

@@ -54,7 +54,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 [connect](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-connect) to connect the device client
+1. Call [connect](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-connect) to connect the device client.
 
 For example: