Merge pull request #183716 from ElazarK/devicebuilders-reorg

device builder toc redesign

Author: hmacgregor1

.openpublishing.redirection.json

@@ -15467,6 +15467,46 @@
       "redirect_url": "/azure/developer/chef/windows-vm-configure",
       "redirect_document_id": false
     },
+    {
+      "source_path_from_root": "/articles/defender-for-iot/device-builders/quickstart-configure-your-solution.md",
+      "redirect_url": "/azure/defender-for-iot/device-builders/tutorial-configure-your-solution",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/defender-for-iot/device-builders/quickstart-create-micro-agent-module-twin.md",
+      "redirect_url": "/azure/defender-for-iot/device-builders/tutorial-create-micro-agent-module-twin",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/defender-for-iot/device-builders/quickstart-standalone-agent-binary-installation.md",
+      "redirect_url": "/azure/defender-for-iot/device-builders/tutorial-standalone-agent-binary-installation",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/defender-for-iot/device-builders/how-to-configure-agent-based-solution.md",
+      "redirect_url": "/azure/defender-for-iot/device-builders/tutorial-configure-agent-based-solution",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/defender-for-iot/device-builders/quickstart-investigate-security-recommendations.md",
+      "redirect_url": "/azure/defender-for-iot/device-builders/tutorial-investigate-security-recommendations",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/defender-for-iot/device-builders/quickstart-investigate-security-alerts.md",
+      "redirect_url": "/azure/defender-for-iot/device-builders/tutorial-investigate-security-alerts",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/defender-for-iot/device-builders/tutorial-configure-micro-agent-twin.md",
+      "redirect_url": "/azure/defender-for-iot/device-builders/how-to-configure-micro-agent-twin",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/defender-for-iot/device-builders/quickstart-azure-rtos-security-module.md",
+      "redirect_url": "/azure/defender-for-iot/device-builders/how-to-quickstart-azure-rtos-security-module",
+      "redirect_document_id": false
+    },    
     {
       "source_path_from_root": "/articles/defender-for-iot/organizations/integration-cisco-ise-pxgrid.md",
       "redirect_url": "/azure/defender-for-iot/organizations/integration-forescout",

articles/defender-for-iot/device-builders/TOC.yml

@@ -13,27 +13,26 @@
 - name: Quickstarts
   expanded: true
   items:
-  - name: Onboard to Defender for IoT agent-based solution
-    displayName: IoT Hub, existing, enable
+  - name: Enable Microsoft Defender for IoT on Azure IoT Hub
+    displayName: IoT Hub, existing, enable, enable, onboard
     href: quickstart-onboard-iot-hub.md
-  - name: Install Defender for IoT micro agent (Preview)
-    displayName: package, authentication, methods, certificate, authenticate, version
-    href: quickstart-standalone-agent-binary-installation.md
-  - name: Create a Defender for IoT micro agent module twin (Preview)
-    href: quickstart-create-micro-agent-module-twin.md
-  - name: Configure Defender-IoT-micro-agent for Azure RTOS
-    href: quickstart-azure-rtos-security-module.md
-  - name: Add Azure resources to your IoT solution
+- name: Tutorials
+  items:
+  - name: Add a resource group to your IoT solution
     displayName: resources, monitored, resource
-    href: quickstart-configure-your-solution.md
+    href: tutorial-configure-your-solution.md
+  - name: Create a DefenderforIoTMicroAgent module twin (Preview)
+    href: tutorial-create-micro-agent-module-twin.md
+  - name: Install the Microsoft Defender for IoT micro agent (Preview)
+    displayName: package, authentication, methods, certificate, authenticate, version
+    href: tutorial-standalone-agent-binary-installation.md
+  - name: Configure Microsoft Defender for IoT agent-based solution
+    displayName: data, collection, geolocation, log analytics, raw events
+    href: tutorial-configure-agent-based-solution.md
   - name: Investigate security recommendations
-    href: quickstart-investigate-security-recommendations.md
+    href: tutorial-investigate-security-recommendations.md
   - name: Investigate security alerts
-    href: quickstart-investigate-security-alerts.md
-- name: Tutorials
-  items:
-  - name: Configure a micro agent twin
-    href: tutorial-configure-micro-agent-twin.md
+    href: tutorial-investigate-security-alerts.md
 - name: Concepts
   items:
   - name: Agent portfolio overview and OS support (Preview)                     
@@ -72,11 +71,10 @@
   - name: Connect to Microsoft Sentinel
     displayName: log analytics, service notes
     href: how-to-configure-with-sentinel.md
-  - name: Configure Microsoft Defender for IoT agent-based solution
-    displayName: data, collection, geolocation, log analytics, raw events
-    href: how-to-configure-agent-based-solution.md
   - name: Investigate CIS benchmark recommendation
     href: how-to-investigate-cis-benchmark.md
+  - name: Configure a micro agent twin
+    href: how-to-configure-micro-agent-twin.md
   - name: Create custom alerts
     displayName: security group
     href: quickstart-create-custom-alerts.md

articles/defender-for-iot/device-builders/how-to-configure-agent-based-solution.md

@@ -1,29 +1,23 @@
 ---
 title: Configure a micro agent twin
-description: In this tutorial, you will learn how to configure a micro agent twin.
+description: Learn how to configure a micro agent twin.
 author: ElazarK
 ms.author: v-ekrieg
-ms.topic: tutorial
-ms.date: 01/05/2022
-ms.custom: template-tutorial
+ms.topic: how-to
+ms.date: 01/16/2022
 ---
 
-# Tutorial: Configure a micro agent twin
+# Configure a micro agent twin
 
-This tutorial will help you learn how to configure a micro agent twin.
-
-In this tutorial, you learn how to:
-
-> [!div class="checklist"]
-> - Configure a micro agent twin
+Learn how to configure a micro agent twin.
 
 ## Prerequisites
 
 - An Azure account. If you do not already have an Azure account, you can [create your Azure free account today](https://azure.microsoft.com/free/).
 
 - A Defender for IoT subscription.
 
-- An existing IoT Hub with: [A connected device](quickstart-standalone-agent-binary-installation.md), and [A micro agent module twin](quickstart-create-micro-agent-module-twin.md).
+- An existing IoT Hub with: [A connected device](tutorial-standalone-agent-binary-installation.md), and [A micro agent module twin](tutorial-create-micro-agent-module-twin.md).
 
 ## Micro agent configuration
 
@@ -33,7 +27,7 @@ In this tutorial, you learn how to:
 
 1. Search for, and select **IoT Hub**.
 
-    :::image type="content" source="media/tutorial-micro-agent-configuration/iot-hub.png" alt-text="Screenshot of searching for the IoT hub in the searchbar.":::
+    :::image type="content" source="media/tutorial-micro-agent-configuration/iot-hub.png" alt-text="Screenshot of searching for the IoT hub in the search bar.":::
 
 1. Select your IoT Hub from the list.
 
@@ -47,7 +41,7 @@ In this tutorial, you learn how to:
 
     :::image type="content" source="media/tutorial-micro-agent-configuration/module-id.png" alt-text="Screenshot of the device's module ID selection screen.":::
 
-1. In the Module Identity Details screen select **Module Identity Twin**.
+1. In the Module Identity Details screen, select **Module Identity Twin**.
 
     :::image type="content" source="media/tutorial-micro-agent-configuration/module-identity-twin.png" alt-text="Screenshot of the Module Identity Details screen.":::
 
@@ -61,10 +55,6 @@ In this tutorial, you learn how to:
 
     If the agent fails to set the new configuration, the value of `"latest_state"`, under the `"reported"` section will show `"failed"`. If this occurs, the `"latest_invalid_fields"` will contain a list of the fields that are invalid.
 
-## Clean up resources
-
-There are no resources to clean up.
-
 ## Next steps
 
-In this tutorial, you learned how to configure a micro agent twin. Continue on to learn about additional [Micro agent configurations (Preview)](concept-micro-agent-configuration.md).
+You learned how to configure a micro agent twin. Continue on to learn about other [Micro agent configurations (Preview)](concept-micro-agent-configuration.md).