Merge pull request #206742 from w-azure/winona-device-twins

Updated Device Twins

Author: 19BMG00

articles/iot-hub/iot-hub-csharp-csharp-twin-getstarted.md

@@ -48,11 +48,13 @@ In this article, you create these .NET console apps:
 
 In this section, you create a .NET console app, using C#, that adds location metadata to the device twin associated with **myDeviceId**. It then queries the device twins stored in the IoT hub selecting the devices located in the US, and then the ones that reported a cellular connection.
 
-1. In Visual Studio, select **Create a new project**. In **Create new project**, select **Console App (.NET Framework)**, and then select **Next**.
+1. In Visual Studio, select **File > New > Project**. In **Create a new project**, select **Console App (.NET Framework)**, and then select **Next**.
 
-1. In **Configure your new project**, name the project **AddTagsAndQuery**.
+1. In **Configure your new project**, name the project **AddTagsAndQuery**, the select **Next**.
 
-    ![Configure your AddTagsAndQuery project](./media/iot-hub-csharp-csharp-twin-getstarted/config-addtagsandquery-app.png)
+   :::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":::
+
+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**.
 

articles/iot-hub/media/iot-hub-csharp-csharp-twin-getstarted/config-addtagsandquery-app.png

@@ -17,16 +17,16 @@ To create a shared access policy that grants **service connect** and **registry
 
 1. On the left-side pane of your hub, select **Shared access policies**.
 
-1. From the top menu above the list of policies, select **Add**.
+1. From the top menu above the list of policies, select **Add shared policy access policy**.
 
-1. Under **Add shared access policy**, enter a descriptive name for your policy, such as *serviceAndRegistryRead*. Under **Permissions**, select **Registry read** and **Service connect**, and then select **Add**.
+1. In the **Add shared access policy** pane on the right, enter a descriptive name for your policy, such as *serviceAndRegistryRead*. Under **Permissions**, select **Registry Read** and **Service Connect**, and then select **Add**.
 
-    :::image type="content" source="./media/iot-hub-include-find-custom-connection-string/iot-hub-add-custom-policy.png" alt-text="Screen capture that shows how to add a new shared access policy" border="true":::
+    :::image type="content" source="./media/iot-hub-include-find-custom-connection-string/iot-hub-add-custom-policy.png" alt-text="Screen capture that shows how to add a new shared access policy." border="true" lightbox="./media/iot-hub-include-find-custom-connection-string/iot-hub-add-custom-policy.png":::
 
 1. Select your new policy from the list of policies.
 
 1. Select the copy icon for the **Primary connection string** and save the value.
 
-    :::image type="content" source="./media/iot-hub-include-find-custom-connection-string/iot-hub-get-connection-string.png" alt-text="Screen capture that shows how to retrieve the connection string" border="true":::
+    :::image type="content" source="./media/iot-hub-include-find-custom-connection-string/iot-hub-get-connection-string.png" alt-text="Screen capture that shows how to retrieve the connection string." border="true" lightbox="./media/iot-hub-include-find-custom-connection-string/iot-hub-get-connection-string.png":::
 
 For more information about IoT Hub shared access policies and permissions, see [Access control and permissions](../articles/iot-hub/iot-hub-dev-guide-sas.md#access-control-and-permissions).

includes/iot-hub-include-find-custom-connection-string.md

@@ -39,12 +39,11 @@ Tags and properties cannot contain arrays, but objects can be nested.
 
 The following illustration shows device twin organization:
 
-![Device twin image showing functionality](./media/iot-hub-selector-twin-get-started/twin.png)
+:::image type="content" source="./media/iot-hub-selector-twin-get-started/twin.png" alt-text="Screenshot of a device twin concept diagram.":::
 
 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](../articles/iot-hub/iot-hub-devguide-device-twins.md). For more information about querying, see [IoT Hub query language](../articles/iot-hub/iot-hub-devguide-query-language.md).
 
-
 This article shows you how to:
 
 * Create a back-end app that adds tags to a device twin, and a simulated device app that reports its connectivity channel as a reported property on the device twin.