Edits

Author: gsteve88

articles/iot-hub/how-to-schedule-broadcast-jobs.md

@@ -14,15 +14,15 @@ zone_pivot_groups: iot-hub-howto-c2d-1
 
 # How to schedule and broadcast jobs
 
-This article shows you how to create back-end app code to schedule device direct method and device twin desired property updates.
+This article shows you how to create back-end app code to schedule and broadcast jobs.
 
-Use Azure IoT Hub to schedule and track jobs that update millions of devices. Use jobs to:
+Use Azure IoT Hub to schedule and track jobs that update up to millions of devices for the following:
 
 * Update desired properties
 * Update tags
 * Invoke direct methods
 
-A job wraps one of these actions and tracks the execution against a set of devices that is defined by a device twin query. For example, a back-end app can use a job to invoke a direct method on 10,000 devices that reboots the devices. You specify the set of devices with a device twin query and schedule the job to run at a future time. The job tracks progress as each of the devices receives and executes the reboot direct method.
+A job wraps one of these actions and tracks the execution against a set of devices that is defined by a device twin query. For example, a back-end app can use a job to invoke a direct method on 10,000 devices that reboots the devices. You specify the set of devices with a device twin query and schedule the job to run at a future time. The job monitors progress as each of the devices receives and executes the reboot direct method.
 
 To learn more about each of these capabilities, see:
 

includes/iot-hub-howto-schedule-broadcast-jobs-dotnet.md

@@ -15,9 +15,9 @@ ms.custom: [amqp, mqtt, "Role: Cloud Development", "Role: IoT Device", devx-trac
 
 ## Overview
 
-This article describes how to use the [Azure IoT SDK for .NET](https://github.com/Azure/azure-iot-sdk-csharp/blob/main/readme.md) to create backend service application code to schedule job to invoke a direct method or perform a device twin desired property update on one or more devices.
+This article describes how to use the [Azure IoT SDK for .NET](https://github.com/Azure/azure-iot-sdk-csharp/blob/main/readme.md) to create backend service application code to a schedule job to invoke a direct method or perform a device twin desired property update on one or more devices.
 
-### Add service NuGet Package
+### Add service NuGet package
 
 Backend service applications require the **Microsoft.Azure.Devices** NuGet package.
 
@@ -62,14 +62,15 @@ jobClient = JobClient.CreateFromConnectionString(connString);
 
 ### Create a direct method update job
 
-Use [ScheduleDeviceMethodAsync](/dotnet/api/microsoft.azure.devices.jobclient.scheduledevicemethodasync) to create a new direct method to run a direct method on one or multiple devices.
+Use [ScheduleDeviceMethodAsync](/dotnet/api/microsoft.azure.devices.jobclient.scheduledevicemethodasync) to create a job to run a direct method on one or multiple devices.
 
-This example schedules a job for a direct method method named "LockDoor".
+This example schedules a job for a direct method method named "LockDoor" on one device named "Device-1". The device(s) included in the scheduled job are contained second parameter as a query condition.
 
 ```csharp
-string methodJobId = Guid.NewGuid().ToString();
-static string deviceId = "Device-1";
+string methodJobId = Guid.NewGuid().ToString();  // a unique job ID
+static string deviceId = "Device-1";             // In this example, there is only one device affected.
 
+// The CloudToDeviceMethod record specifies the direct method name and device connection timeout.
 CloudToDeviceMethod directMethod = 
 new CloudToDeviceMethod("LockDoor", TimeSpan.FromSeconds(5), 
 TimeSpan.FromSeconds(5));

includes/iot-hub-howto-schedule-broadcast-jobs-node.md

@@ -129,6 +129,9 @@ Call `scheduleTwinUpdate` to schedule the device twin desired property update jo
 
 ```javascript
 var twinJobId = uuid.v4();
+var queryCondition = "deviceId IN ['myDeviceId']";
+var startTime = new Date();
+var maxExecutionTimeInSeconds =  300;
 
 console.log('scheduling Twin Update job with id: ' + twinJobId);
 jobClient.scheduleTwinUpdate(twinJobId,