Updates

Author: gsteve88

articles/iot-hub/how-to-device-twins.md

@@ -1,7 +1,7 @@
 ---
 title: Get started with Azure IoT Hub device twins
 titleSuffix: Azure IoT Hub
-description: How to use Azure IoT Hub device twins and the Azure IoT SDKs to create and simulate devices, add tags to device twins, and execute IoT Hub queries. 
+description: How to use the Azure IoT SDKs to create device and backend service application code for device twins.
 author: kgremban
 ms.author: kgremban
 manager: lizross
@@ -47,19 +47,18 @@ The following illustration shows device twin organization:
 
 It is useful to review the various device twin fields that are available using the Azure portal. To learn how, see [How to view and update devices based on device twin properties](/azure/iot-hub/manage-device-twins).
 
-Additionally, the solution back end can query device twins based on all the above data.
-For more information about device twins, see [Understand device twins](iot-hub-devguide-device-twins.md). For more information about querying, see [IoT Hub query language](iot-hub-devguide-query-language.md).
+Additionally, the solution back end can query device twins based on all the above data. For more information about querying, see [IoT Hub query language](iot-hub-devguide-query-language.md).
 
 This article shows you how to:
 
-* Retrieve a device twin and update reported properties
+* View device twin and update reported properties
 * Update device twin tags
 * Create a device desired property update notificaton callback
 * Use a backend application to update tags and desired properties
 * Query devices from your back-end app using filters on the tags and properties previously created
 
 > [!NOTE]
-> This article is meant to complement compilable [Azure IoT SDKs](iot-hub-devguide-sdks.md) samples that are referenced from within this article. You can use SDK tools to build both device and back-end apps.
+> This article is meant to complement [Azure IoT SDKs](iot-hub-devguide-sdks.md) samples that are referenced from within this article. You can use SDK tools to build both device and back-end applications.
 
 ## Prerequisites
 

includes/iot-hub-howto-device-twins-dotnet.md

@@ -1,7 +1,7 @@
 ---
 title: Get started with Azure IoT Hub device twins (.NET)
 titleSuffix: Azure IoT Hub
-description: How to use Azure IoT Hub device twins and the Azure IoT SDKs for .NET to create and simulate devices, add tags to device twins, and execute IoT Hub queries. 
+description: How to use the Azure IoT SDK for .NET to create device and backend service application code for device twins.
 author: kgremban
 ms.author: kgremban
 ms.service: iot-hub
@@ -13,9 +13,9 @@ ms.custom: mqtt, devx-track-csharp, devx-track-dotnet
 
 ## Overview
 
-This section describes how to use the .NET/C# SDK to create device and backend service application code.
+This unit describes how to use the Azure SDK for .NET to create device and backend service application code for device twins.
 
-Visual Studio is required to use the .NET/C# SDK.
+Visual Studio is required to use the SDK.
 
 ## Create a device application
 
@@ -52,7 +52,7 @@ using Microsoft.Azure.Devices.Client;
 using Microsoft.Azure.Devices.Shared;
 using Newtonsoft.Json;
 
-static string DeviceConnectionString = "{Device connection string}";
+static string DeviceConnectionString = "{IoT Hub device connection string}";
 static _deviceClient = null;
 _deviceClient = DeviceClient.CreateFromConnectionString(DeviceConnectionString, 
    TransportType.Mqtt);
@@ -162,12 +162,12 @@ To install the **Microsoft.Azure.Devices** NuGet package:
 
 ### Connect to IoT hub
 
-Connect a backend application to a device using [CreateFromConnectionString](/dotnet/api/microsoft.azure.devices.client.deviceclient.createfromconnectionstring?#microsoft-azure-devices-client-deviceclient-createfromconnectionstring(system-string-microsoft-azure-devices-client-transporttype)). As a parameter, supply the IoT Hub service connection string that you created in the Prerequisites section. The backend application connects to the device through IoT Hub.
+Connect a backend application to a device using [CreateFromConnectionString](/dotnet/api/microsoft.azure.devices.client.deviceclient.createfromconnectionstring?#microsoft-azure-devices-client-deviceclient-createfromconnectionstring(system-string-microsoft-azure-devices-client-transporttype)). As a parameter, supply the **IoT Hub service connection string** that you created in the Prerequisites section. The backend application connects to the device through IoT Hub.
 
 ```csharp
 using Microsoft.Azure.Devices;
 static RegistryManager registryManager;
-static string connectionString = "{service connection string}";
+static string connectionString = "{IoT hub service connection string}";
 registryManager = RegistryManager.CreateFromConnectionString(connectionString);
 ```
 

includes/iot-hub-howto-device-twins-java.md

@@ -1,7 +1,7 @@
 ---
 title: Get started with Azure IoT Hub device twins (Java)
 titleSuffix: Azure IoT Hub
-description: How to use Azure IoT Hub device twins and the Azure IoT SDKs for Java to create and simulate devices, add tags to device twins, and execute IoT Hub queries. 
+description: How to use the Azure IoT SDK for Java to create device and backend service application code for device twins.
 author: kgremban
 ms.author: kgremban
 ms.service: iot-hub
@@ -13,9 +13,9 @@ ms.custom: mqtt, devx-track-java, devx-track-extended-java
 
 ## Overview
 
-This unit describes how to use the Java SDK to create device and backend service application code.
+This unit describes how to use the Azure SDK for Java to create device and backend service application code for device twins.
 
-[Java SE Development Kit 8](/azure/developer/java/fundamentals/) is required to run SDK code. Make sure you select **Java 8** under **Long-term support** to navigate to downloads for JDK 8.
+[Java SE Development Kit 8](/azure/developer/java/fundamentals/) is required to use the SDK. Make sure you select **Java 8** under **Long-term support** to navigate to downloads for JDK 8.
 
 ## Create a device application
 
@@ -51,7 +51,7 @@ To connect to a device:
 1. Use the `DeviceClient` constructor to add the device primary connection string and protocol.
 
     ```java
-    String connString = "{device connection string}";
+    String connString = "{IoT hub device connection string}";
     DeviceClient client = new DeviceClient(connString, protocol);
     ```
 
@@ -156,7 +156,7 @@ The `ServiceClient` [DeviceTwin](/java/api/com.microsoft.azure.sdk.iot.service.d
 To connect to IoT Hub to view and update device twin information:
 
 1. Create a [DeviceTwinClientOptions](/java/api/com.microsoft.azure.sdk.iot.service.devicetwin.devicetwinclientoptions?#com-microsoft-azure-sdk-iot-service-devicetwin-devicetwinclientoptions-devicetwinclientoptions()) object. Set any options that are needed for your application. These options are passed to the `DeviceTwin` object.
-1. Use a [DeviceTwin](/java/api/com.microsoft.azure.sdk.iot.service.devicetwin.devicetwin?#com-microsoft-azure-sdk-iot-service-devicetwin-devicetwin-devicetwin(java-lang-string)) constructor to create the connection to IoT hub. The `DeviceTwin` object handles the communication with your IoT hub. As parameters, supply the IoT Hub service connection string that you created in the Prerequisites section and the `DeviceTwinClientOptions` object.
+1. Use a [DeviceTwin](/java/api/com.microsoft.azure.sdk.iot.service.devicetwin.devicetwin?#com-microsoft-azure-sdk-iot-service-devicetwin-devicetwin-devicetwin(java-lang-string)) constructor to create the connection to IoT hub. The `DeviceTwin` object handles the communication with your IoT hub. As parameters, supply the **IoT Hub service connection string** that you created in the Prerequisites section and the `DeviceTwinClientOptions` object.
 1. The [DeviceTwinDevice](/java/api/com.microsoft.azure.sdk.iot.service.devicetwin.devicetwindevice) object represents the device twin with its properties and tags.
 
 ```java
@@ -167,7 +167,7 @@ import java.io.IOException;
 import java.util.HashSet;
 import java.util.Set;
 
-public static final String iotHubConnectionString = "{IoT Hub service connection string}";
+public static final String iotHubConnectionString = "{IoT hub service connection string}";
 public static final String deviceId = "myDeviceId";
 public static final String region = "US";
 public static final String plant = "Redmond43";

includes/iot-hub-howto-device-twins-node.md

@@ -1,7 +1,7 @@
 ---
 title: Get started with Azure IoT Hub device twins (Node.js)
 titleSuffix: Azure IoT Hub
-description: How to use Azure IoT Hub device twins and the Azure IoT SDKs for Node.js to create and simulate devices, add tags to device twins, and execute IoT Hub queries. 
+description: How to use the Azure IoT SDK for Node.js to create device and backend service application code for device twins.
 author: kgremban
 ms.author: kgremban
 ms.service: iot-hub
@@ -11,6 +11,12 @@ ms.date: 07/20/2024
 ms.custom: mqtt, devx-track-js
 ---
 
+## Overview
+
+This unit describes how to use the Azure SDK for Python to create device and backend service application code for device twins.
+
+Node.js version 10.0.x or later is required to use the SDK.
+
 ## Create a device application
 
 Device applications can read and write twin reported properties, and be notified of desired twin property changes that have been set by a backend application or IoT Hub.
@@ -232,12 +238,12 @@ The [Registry](/javascript/api/azure-iothub/registry?#azure-iothub-registry-gett
 
 ### Connect to IoT hub
 
-Use [fromConnectionString](/javascript/api/azure-iothub/registry?#azure-iothub-registry-fromconnectionstring) to connect to IoT hub. As a parameter, supply the IoT Hub service connection string that you created in the Prerequisites section.
+Use [fromConnectionString](/javascript/api/azure-iothub/registry?#azure-iothub-registry-fromconnectionstring) to connect to IoT hub. As a parameter, supply the **IoT hub service connection string** that you created in the Prerequisites section.
 
 ```javascript
 'use strict';
 var iothub = require('azure-iothub');
-var connectionString = '{iot Hub service connection string}';
+var connectionString = '{Iot Hub service connection string}';
 var registry = iothub.Registry.fromConnectionString(connectionString);
 ```
 

includes/iot-hub-howto-device-twins-python.md

@@ -1,7 +1,7 @@
 ---
 title: Get started with Azure IoT Hub device twins (Python)
 titleSuffix: Azure IoT Hub
-description: How to use Azure IoT Hub device twins and the Azure IoT SDKs for Python to create and simulate devices, add tags to device twins, and execute IoT Hub queries. 
+description: How to use the Azure IoT SDK for Python to create device and backend service application code for device twins.
 author: kgremban
 ms.author: kgremban
 ms.service: iot-hub
@@ -13,7 +13,7 @@ ms.custom: mqtt, devx-track-python, py-fresh-zinc
 
 ## Overview
 
-This section describes how to use the Python SDK to create device and backend service application code.
+This unit describes how to use the Azure SDK for Python to create device and backend service application code for device twins.
 
 [Python version 3.7 or later](https://www.python.org/downloads/) is recommended. Make sure to use the 32-bit or 64-bit installation as required by your setup. When prompted during the installation, make sure to add Python to your platform-specific environment variable.
 
@@ -43,7 +43,7 @@ from azure.iot.device.aio import IoTHubDeviceClient
 
 # substitute the device connection string in conn_str
 # and add it to the IoTHubDeviceClient object
-conn_str = "IOTHUB_DEVICE_CONNECTION_STRING"
+conn_str = "{IOT hub device connection string}"
 device_client = IoTHubDeviceClient.create_from_connection_string(conn_str)
 
 # connect the application to the device
@@ -133,7 +133,7 @@ The [IoTHubRegistryManager](/python/api/azure-iot-hub/azure.iot.hub.iothubregist
 
 ### Connect to IoT hub
 
-Connect to IoT hub using [from_connection_string](/python/api/azure-iot-hub/azure.iot.hub.iothubregistrymanager?#azure-iot-hub-iothubregistrymanager-from-connection-string). As a parameter, supply the IoT Hub service connection string that you created in the Prerequisites section.
+Connect to IoT hub using [from_connection_string](/python/api/azure-iot-hub/azure.iot.hub.iothubregistrymanager?#azure-iot-hub-iothubregistrymanager-from-connection-string). As a parameter, supply the **IoT Hub service connection string** that you created in the Prerequisites section.
 
 After connecting you can update the device twin.
 
@@ -144,7 +144,7 @@ from azure.iot.hub import IoTHubRegistryManager
 from azure.iot.hub.models import Twin, TwinProperties, QuerySpecification, QueryResult
 
 # Connect to IoT hub
-IOTHUB_CONNECTION_STRING = "[IoT Hub service connection string]"
+IOTHUB_CONNECTION_STRING = "{IoT hub service connection string}"
 iothub_registry_manager = IoTHubRegistryManager.from_connection_string(IOTHUB_CONNECTION_STRING)
 ```