Merge pull request #230930 from kgremban/mar15-metarefresh-twins

Metadata and filename refresh -- twins

Author: v-dirichards

articles/iot-hub/.openpublishing.redirection.iot-hub.json

@@ -631,6 +631,61 @@
       "redirect_url": "/azure/iot-hub/iot-hub-intel-edison-kit-node-get-started",
       "redirect_document_id": false
     },
+    {
+      "source_path_from_root": "/articles/iot-hub/twin-get-started-cli.md",
+      "redirect_url": "/azure/iot-hub/device-twins-cli",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-csharp-csharp-twin-getstarted.md",
+      "redirect_url": "/azure/iot-hub/device-twins-dotnet",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-java-java-twin-getstarted.md",
+      "redirect_url": "/azure/iot-hub/device-twins-java",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-node-node-twin-getstarted.md",
+      "redirect_url": "/azure/iot-hub/device-twins-node",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-python-twin-getstarted.md",
+      "redirect_url": "/azure/iot-hub/device-twins-python",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-node-node-module-twin-getstarted.md",
+      "redirect_url": "/azure/iot-hub/module-twins-node",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-c-c-module-twin-getstarted.md",
+      "redirect_url": "/azure/iot-hub/module-twins-c",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-csharp-csharp-module-twin-getstarted.md",
+      "redirect_url": "/azure/iot-hub/module-twins-dotnet",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-python-python-module-twin-getstarted.md",
+      "redirect_url": "/azure/iot-hub/module-twins-python",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-portal-csharp-module-twin-getstarted.md",
+      "redirect_url": "/azure/iot-hub/module-twins-portal-dotnet",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/module-twin-getstarted-cli.md",
+      "redirect_url": "/azure/iot-hub/module-twins-cli",
+      "redirect_document_id": true
+    },
     {
       "source_path_from_root": "/articles/iot-hub/iot-hub-gateway-sdk-physical-device.md",
       "redirect_url": "/azure/iot-hub/iot-hub-iot-edge-physical-device",
@@ -658,7 +713,7 @@
     },
     {
       "source_path_from_root": "/articles/iot-hub/iot-hub-csharp-node-twin-getstarted.md",
-      "redirect_url": "/azure/iot-hub/iot-hub-node-node-twin-getstarted",
+      "redirect_url": "/azure/iot-hub/device-twins-node",
       "redirect_document_id": false
     },
     {

articles/iot-hub/TOC.yml

@@ -342,39 +342,39 @@
           items:
             - name: CLI
               displayName: device twins
-              href: twin-get-started-cli.md
+              href: device-twins-cli.md
             - name: .NET
               displayName: device twins
-              href: iot-hub-csharp-csharp-twin-getstarted.md
+              href: device-twins-dotnet.md
             - name: Python
               displayName: device twins
-              href: iot-hub-python-twin-getstarted.md
+              href: device-twins-python.md
             - name: Node.js
               displayName: device twins
-              href: iot-hub-node-node-twin-getstarted.md
+              href: device-twins-node.md
             - name: Java
               displayName: device twins
-              href: iot-hub-java-java-twin-getstarted.md
+              href: device-twins-java.md
         - name: Get started with module twins
           items:
             - name: Portal
               displayName: module twins, module identity
-              href: iot-hub-portal-csharp-module-twin-getstarted.md
+              href: module-twins-portal-dotnet.md
             - name: CLI
               displayName: module twins, module identity
-              href: module-twin-getstarted-cli.md
+              href: module-twins-cli.md
             - name: .NET
               displayName: module twins, module identity
-              href: iot-hub-csharp-csharp-module-twin-getstarted.md
+              href: module-twins-dotnet.md
             - name: Python
               displayName: module twins, module identity
-              href: iot-hub-python-python-module-twin-getstarted.md
+              href: module-twins-python.md
             - name: Node.js
               displayName: module twins, module identity
-              href: iot-hub-node-node-module-twin-getstarted.md
+              href: module-twins-node.md
             - name: C
               displayName: module twins, module identity
-              href: iot-hub-c-c-module-twin-getstarted.md
+              href: module-twins-c.md
         - name: Get started with device management
           items:
             - name: CLI

articles/iot-hub/twin-get-started-cli.md renamed to articles/iot-hub/device-twins-cli.md

@@ -1,14 +1,14 @@
 ---
 title: Get started with Azure IoT Hub device twins (Azure CLI)
+titleSuffix: Azure IoT Hub
 description: How to use Azure IoT Hub device twins and the Azure CLI to create and simulate devices, add tags to device twins, and execute IoT Hub queries. 
 author: kgremban
 
+ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
 ms.devlang: azurecli
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 02/17/2023
-ms.author: kgremban
 ms.custom: "mqtt, devx-track-azurecli"
 ---
 

articles/iot-hub/iot-hub-csharp-csharp-twin-getstarted.md renamed to articles/iot-hub/device-twins-dotnet.md

@@ -1,14 +1,14 @@
 ---
-title: Get started with Azure IoT Hub device twins (.NET/.NET) | Microsoft Docs
-description: How to use Azure IoT Hub device twins to add tags and then use an IoT Hub query. You use the Azure IoT device SDK for .NET to implement the simulated device app and the Azure IoT service SDK for .NET to implement a service app that adds the tags and runs the IoT Hub query.
+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. 
 author: kgremban
 
+ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
 ms.devlang: csharp
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 02/17/2023
-ms.author: kgremban
 ms.custom: "mqtt, devx-track-csharp"
 ---
 
@@ -152,13 +152,13 @@ In this section, you create a .NET console app that connects to your hub as **my
 
 1. Run this app by right-clicking the **ReportConnectivity** project and selecting **Debug**, then **Start new instance**. You should see the app getting the twin information, and then sending connectivity as a ***reported property***.
 
-   ![Run device app to report connectivity](./media/iot-hub-csharp-csharp-twin-getstarted/rundeviceapp.png)
+   ![Run device app to report connectivity](./media/device-twins-dotnet/rundeviceapp.png)
 
    After the device reported its connectivity information, it should appear in both queries.
 
 1. Right-click the **AddTagsAndQuery** project and select **Debug** > **Start new instance** to run the queries again. This time, **myDeviceId** should appear in both query results.
 
-   ![Device connectivity reported successfully](./media/iot-hub-csharp-csharp-twin-getstarted/tagappsuccess.png)
+   ![Device connectivity reported successfully](./media/device-twins-dotnet/tagappsuccess.png)
 
 ## Create a service app that updates desired properties and queries twins
 
@@ -168,15 +168,15 @@ In this section, you create a .NET console app, using C#, that adds location met
 
 1. In **Configure your new project**, name the project **AddTagsAndQuery**, the select **Next**.
 
-   :::image type="content" source="./media/iot-hub-csharp-csharp-twin-getstarted/config-addtagsandquery-app.png" alt-text="Screenshot of how to create a new Visual Studio project." lightbox="./media/iot-hub-csharp-csharp-twin-getstarted/config-addtagsandquery-app.png":::
+   :::image type="content" source="./media/device-twins-dotnet/config-addtagsandquery-app.png" alt-text="Screenshot of how to create a new Visual Studio project." lightbox="./media/device-twins-dotnet/config-addtagsandquery-app.png":::
 
 1. Accept the default version of the .NET Framework, then select **Create** to create the project.
 
 1. In Solution Explorer, right-click the **AddTagsAndQuery** project, and then select **Manage NuGet Packages**.
 
 1. Select **Browse** and search for and select **Microsoft.Azure.Devices**. Select **Install**.
 
-   ![NuGet Package Manager window](./media/iot-hub-csharp-csharp-twin-getstarted/nuget-package-addtagsandquery-app.png)
+   ![NuGet Package Manager window](./media/device-twins-dotnet/nuget-package-addtagsandquery-app.png)
 
    This step downloads, installs, and adds a reference to the [Azure IoT service SDK](https://www.nuget.org/packages/Microsoft.Azure.Devices/) NuGet package and its dependencies.
 
@@ -240,7 +240,7 @@ In this section, you create a .NET console app, using C#, that adds location met
 
 1. Run this application by right-clicking on the **AddTagsAndQuery** project and selecting **Debug**, followed by **Start new instance**. You should see one device in the results for the query asking for all devices located in **Redmond43** and none for the query that restricts the results to devices that use a cellular network.
 
-   ![Query results in window](./media/iot-hub-csharp-csharp-twin-getstarted/addtagapp.png)
+   ![Query results in window](./media/device-twins-dotnet/addtagapp.png)
 
 In this article, you:
 

articles/iot-hub/iot-hub-java-java-twin-getstarted.md renamed to articles/iot-hub/device-twins-java.md

@@ -1,13 +1,13 @@
 ---
-title: Get started with Azure IoT Hub device twins (Java) | Microsoft Docs
-description: How to use Azure IoT Hub device twins to add tags and then use an IoT Hub query. You use the Azure IoT device SDK for Java to implement the device app and the Azure IoT service SDK for Java to implement a service app that adds the tags and runs the IoT Hub query.
+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. 
 author: kgremban
 
 ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
 ms.devlang: java
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 02/17/2023
 ms.custom: mqtt, devx-track-java
 ---
@@ -375,7 +375,7 @@ You are now ready to run the console apps.
     mvn exec:java -Dexec.mainClass="com.mycompany.app.App"
     ```
 
-    ![Screenshot that shows the output from the command to run the add tags query service app.](./media/iot-hub-java-java-twin-getstarted/service-app-1.png)
+    ![Screenshot that shows the output from the command to run the add tags query service app.](./media/device-twins-java/service-app-1.png)
 
     You can see the **plant** and **region** tags added to the device twin. The first query returns your device, but the second does not.
 
@@ -385,15 +385,15 @@ You are now ready to run the console apps.
     mvn exec:java -Dexec.mainClass="com.mycompany.app.App"
     ```
 
-    ![The device client adds the connectivity Type reported property](./media/iot-hub-java-java-twin-getstarted/device-app-1.png)
+    ![The device client adds the connectivity Type reported property](./media/device-twins-java/device-app-1.png)
 
 3. At a command prompt in the **add-tags-query** folder, run the following command to run the **add-tags-query** service app a second time:
 
     ```cmd/sh
     mvn exec:java -Dexec.mainClass="com.mycompany.app.App"
     ```
 
-    ![Java IoT Hub service app to update tag values and run device queries](./media/iot-hub-java-java-twin-getstarted/service-app-2.png)
+    ![Java IoT Hub service app to update tag values and run device queries](./media/device-twins-java/service-app-2.png)
 
     Now that your device has sent the **connectivityType** property to IoT Hub, the second query returns your device.
 

articles/iot-hub/iot-hub-node-node-twin-getstarted.md renamed to articles/iot-hub/device-twins-node.md

@@ -1,13 +1,14 @@
 ---
-title: Get started with Azure IoT Hub device twins (Node) | Microsoft Docs
-description: How to use Azure IoT Hub device twins to add tags and then use an IoT Hub query. You use the Azure IoT SDKs for Node.js to implement the simulated device app and a service app that adds the tags and runs the IoT Hub query.
+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. 
 author: kgremban
+
+ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
-ms.devlang: javascript
-ms.topic: conceptual
+ms.devlang: nodejs
+ms.topic: how-to
 ms.date: 02/17/2023
-ms.author: kgremban
 ms.custom: mqtt, devx-track-js
 ---
 
@@ -124,7 +125,7 @@ In this section, you create a Node.js console app that connects to your hub as *
 
     This time **myDeviceId** should appear in both query results.
 
-    ![Show myDeviceId in both query results](media/iot-hub-node-node-twin-getstarted/service2.png)
+    ![Show myDeviceId in both query results](media/device-twins-node/service2.png)
 
 ## Create a service app that updates desired properties and queries twins
 
@@ -217,7 +218,7 @@ In this section, you create a Node.js console app that adds location metadata to
 
    You should see one device in the results for the query asking for all devices located in **Redmond43** and none for the query that restricts the results to devices that use a cellular network.
 
-   ![See the one device in the query results](media/iot-hub-node-node-twin-getstarted/service1.png)
+   ![See the one device in the query results](media/device-twins-node/service1.png)
 
 In this article, you:
 

articles/iot-hub/iot-hub-python-twin-getstarted.md renamed to articles/iot-hub/device-twins-python.md

@@ -1,13 +1,14 @@
 ---
-title: Get started with Azure IoT Hub device twins (Python) | Microsoft Docs
-description: How to use Azure IoT Hub device twins to add tags and then use an IoT Hub query. You use the Azure IoT SDKs for Python to implement the simulated device app and a service app that adds the tags and runs the IoT Hub query.
+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. 
 author: kgremban
+
+ms.author: kgremban
 ms.service: iot-hub
-services: iot-hub
 ms.devlang: python
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 02/17/2023
-ms.author: kgremban
 ms.custom: mqtt, devx-track-python, py-fresh-zinc
 ---
 
@@ -134,7 +135,7 @@ In this section, you create a Python console app that adds location metadata to
 
     You should see one device in the results for the query asking for all devices located in **Redmond43** and none for the query that restricts the results to devices that use a cellular network. In the next section, you'll create a device app that will use a cellular network and you'll rerun this query to see how it changes.
 
-    ![Screenshot of the first query showing all devices in Redmond.](./media/iot-hub-python-twin-getstarted/service-1.png)
+    ![Screenshot of the first query showing all devices in Redmond.](./media/device-twins-python/service-1.png)
 
 ## Create a device app that updates reported properties
 
@@ -220,7 +221,7 @@ In this section, you create a Python console app that connects to your hub as yo
 
     You should see confirmation the device twin reported properties were updated.
 
-    ![update reported properties from device app](./media/iot-hub-python-twin-getstarted/device-1.png)
+    ![update reported properties from device app](./media/device-twins-python/device-1.png)
 
 8. Now that the device reported its connectivity information, it should appear in both queries. Go back and run the queries again:
 
@@ -230,11 +231,11 @@ In this section, you create a Python console app that connects to your hub as yo
 
     This time your **{Device ID}** should appear in both query results.
 
-    ![second query on service app](./media/iot-hub-python-twin-getstarted/service-2.png)
+    ![second query on service app](./media/device-twins-python/service-2.png)
 
     In your device app, you'll see confirmation that the desired properties twin patch sent by the service app was received.
 
-    ![receive desired properties on device app](./media/iot-hub-python-twin-getstarted/device-2.png)
+    ![receive desired properties on device app](./media/device-twins-python/device-2.png)
 
 In this article, you:
 

articles/iot-hub/iot-hub-devguide-device-twins.md

@@ -365,6 +365,6 @@ Now you have learned about device twins, you may be interested in the following
 
 To try out some of the concepts described in this article, see the following IoT Hub tutorials:
 
-* [How to use the device twin](iot-hub-node-node-twin-getstarted.md)
+* [How to use the device twin](device-twins-node.md)
 * [How to use device twin properties](tutorial-device-twins.md)
 * [Device management with Azure IoT Tools for VS Code](iot-hub-device-management-iot-toolkit.md)

articles/iot-hub/iot-hub-devguide-module-twins.md

@@ -327,4 +327,4 @@ The module app can ignore all notifications with `$version` less or equal than t
 
 To try out some of the concepts described in this article, see the following IoT Hub tutorials:
 
-* [Get started with IoT Hub module identity and module twin using .NET back end and .NET device](iot-hub-csharp-csharp-module-twin-getstarted.md)
+* [Get started with IoT Hub module identity and module twin using .NET back end and .NET device](module-twins-dotnet.md)

articles/iot-hub/iot-hub-device-management-iot-extension-azure-cli-2-0.md

@@ -27,7 +27,7 @@ In this article, you learn how to use the IoT extension for Azure CLI with vario
 
 For more detailed explanation on the differences and guidance on using these options, see [Device-to-cloud communication guidance](iot-hub-devguide-d2c-guidance.md) and [Cloud-to-device communication guidance](iot-hub-devguide-c2d-guidance.md).
 
-Device twins are JSON documents that store device state information (metadata, configurations, and conditions). IoT Hub persists a device twin for each device that connects to it. For more information about device twins, see [Get started with device twins](iot-hub-node-node-twin-getstarted.md).
+Device twins are JSON documents that store device state information (metadata, configurations, and conditions). IoT Hub persists a device twin for each device that connects to it. For more information about device twins, see [Get started with device twins](device-twins-node.md).
 
 [!INCLUDE [iot-hub-get-started-note](../../includes/iot-hub-get-started-note.md)]