Updated content

Author: gsteve88

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

@@ -8,7 +8,7 @@ manager: lizross
 ms.service: azure-iot-hub
 ms.devlang: csharp
 ms.topic: how-to
-ms.date: 1/7/2025
+ms.date: 1/15/2025
 zone_pivot_groups: iot-hub-howto-c2d-1
 ---
 
@@ -18,9 +18,8 @@ This article shows you how to create back-end app code to schedule and broadcast
 
 Use Azure IoT Hub to schedule and track jobs that update up to millions of devices for the following operations:
 
-* Update desired properties
-* Update tags
 * Invoke direct methods
+* Updated device twin desired properties
 
 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.
 

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

@@ -7,15 +7,15 @@ ms.author: kgremban
 ms.service: azure-iot-hub
 ms.devlang: csharp
 ms.topic: include
-ms.date: 1/7/2025
+ms.date: 1/15/2025
 ms.custom: [amqp, mqtt, "Role: Cloud Development", "Role: IoT Device", devx-track-csharp, devx-track-dotnet]
 ---
 
   * Requires Visual Studio
 
 ## 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 a 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 update on one or more devices.
 
 ### Add service NuGet package
 
@@ -60,11 +60,11 @@ jobClient = JobClient.CreateFromConnectionString(connString);
 
 [!INCLUDE [iot-hub-howto-connect-service-iothub-entra-dotnet](iot-hub-howto-connect-service-iothub-entra-dotnet.md)]
 
-### Schedule a direct method update job
+### Schedule a direct method job
 
 Use [ScheduleDeviceMethodAsync](/dotnet/api/microsoft.azure.devices.jobclient.scheduledevicemethodasync) to schedule a job to run a direct method on one or multiple devices.
 
-The [CloudToDeviceMethod](/dotnet/api/microsoft.azure.devices.cloudtodevicemethod.-ctor?#microsoft-azure-devices-cloudtodevicemethod-ctor(system-string-system-timespan-system-timespan)) object to specify the direct method name and device connection timeout values.
+Use the [CloudToDeviceMethod](/dotnet/api/microsoft.azure.devices.cloudtodevicemethod.-ctor?#microsoft-azure-devices-cloudtodevicemethod-ctor(system-string-system-timespan-system-timespan)) object to specify the direct method name and device connection timeout values.
 
 ```csharp
 // The CloudToDeviceMethod record specifies the direct method name and device connection timeout
@@ -73,7 +73,7 @@ new CloudToDeviceMethod("LockDoor", TimeSpan.FromSeconds(5),
 TimeSpan.FromSeconds(5));
 ```
 
-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.
+This example schedules a job for a direct 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();  // a unique job ID
@@ -85,9 +85,9 @@ JobResponse result = await jobClient.ScheduleDeviceMethodAsync(methodJobId,
    (long)TimeSpan.FromMinutes(2).TotalSeconds);
 ```
 
-### Schedule a device desired twin update job
+### Schedule a device twin update job
 
-Use [ScheduleTwinUpdateAsync](/dotnet/api/microsoft.azure.devices.jobclient.scheduledevicemethodasync) to schedule a new desired twin update job to run on one or multiple devices.
+Use [ScheduleTwinUpdateAsync](/dotnet/api/microsoft.azure.devices.jobclient.scheduledevicemethodasync) to schedule a new device twin desired properties and tags update job to run on one or more devices.
 
 First, create and populate a device `Twin` object for the update. For example:
 

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

@@ -7,15 +7,15 @@ ms.author: kgremban
 ms.service: azure-iot-hub
 ms.devlang: java
 ms.topic: include
-ms.date: 1/7/2025
+ms.date: 1/15/2025
 ms.custom: mqtt, devx-track-java, devx-track-extended-java
 ---
 
   * Requires [Java SE Development Kit 8](/azure/developer/java/fundamentals/). Make sure you select **Java 8** under **Long-term support** to navigate to downloads for JDK 8.
 
 ## Overview
 
-This article describes how to use the [Azure IoT SDK for Java](https://github.com/Azure/azure-iot-sdk-java) 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 Java](https://github.com/Azure/azure-iot-sdk-java) to create backend service application code to schedule job to invoke a direct method or perform a device twin update on one or more devices.
 
 ### Service import statements
 
@@ -102,9 +102,9 @@ try {
 
 Use [scheduleUpdateTwin](/java/api/com.microsoft.azure.sdk.iot.service.jobs.jobclient?#com-microsoft-azure-sdk-iot-service-jobs-jobclient-scheduleupdatetwin(java-lang-string-java-lang-string-com-microsoft-azure-sdk-iot-service-devicetwin-devicetwindevice-java-util-date-long)) to schedule a job to run a device twin update on one or multiple devices.
 
-This example method schedules a device twin update job for a specific job Id.
+This example method schedules a device twin update job for a specific job ID.
 
-First, prepare a `DeviceTwinDevice` record for the device twin update. For example:
+First, prepare a [DeviceTwinDevice](/java/api/com.microsoft.azure.sdk.iot.service.devicetwin.devicetwindevice) record for the device twin update. For example:
 
 ```java
 String deviceId = "Device-1";
@@ -144,7 +144,7 @@ try {
 
 ### Monitor a job
 
-Use [getJob](/java/api/com.microsoft.azure.sdk.iot.service.jobs.jobclient?#com-microsoft-azure-sdk-iot-service-jobs-jobclient-getjob(java-lang-string)) to access a job status.
+Use [getJob](/java/api/com.microsoft.azure.sdk.iot.service.jobs.jobclient?#com-microsoft-azure-sdk-iot-service-jobs-jobclient-getjob(java-lang-string)) to fetch job information based on a specific job ID. `getJob` returns a [JobResult](/java/api/com.microsoft.azure.sdk.iot.service.jobs.jobresult) object that contains methods and properties you can use to check job information including running status.
 
 For example:
 

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

@@ -7,15 +7,15 @@ ms.author: kgremban
 ms.service: azure-iot-hub
 ms.devlang: nodejs
 ms.topic: include
-ms.date: 1/7/2025
+ms.date: 1/15/2025
 ms.custom: [amqp, mqtt, devx-track-js]
 ---
 
   *  Requires Node.js version 10.0.x or later
 
 ## Overview
 
-This article describes how to use the [Azure IoT SDK for Node.js](https://github.com/Azure/azure-iot-sdk-node) 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 Node.js](https://github.com/Azure/azure-iot-sdk-node) to create backend service application code to schedule job to invoke a direct method or perform a device twin update on one or more devices.
 
 ### Install service SDK package
 

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

@@ -7,7 +7,7 @@ ms.author: kgremban
 ms.service: azure-iot-hub
 ms.devlang: python
 ms.topic: include
-ms.date: 1/7/2025
+ms.date: 1/15/2025
 ms.custom: mqtt, devx-track-python, py-fresh-zinc
 ---
 
@@ -106,7 +106,7 @@ new_job_response = iothub_job_manager.create_scheduled_job(job_id, job_request)
 
 ### Schedule a device twin update job
 
-Use [create_scheduled_job](/python/api/azure-iot-hub/azure.iot.hub.iothubjobmanager?#azure-iot-hub-iothubjobmanager-create-scheduled-job) to create a new job to run a device twin update on one or multiple devices.
+Use [create_scheduled_job](/python/api/azure-iot-hub/azure.iot.hub.iothubjobmanager?#azure-iot-hub-iothubjobmanager-create-scheduled-job) to create a new job to run a device twin desired properties update on one or multiple devices.
 
 `create_scheduled_job` parameter notes: