Merge pull request #301910 from cwatson-cat/6-26-25-iot-toc-wrk

Azure IoT - TOC rework (scenario-based format)

Author: JamesJBarnett

articles/iot/TOC.yml

@@ -4,7 +4,7 @@ items:
 
   - name: Overview
     items:
-    - name: Introduction
+    - name: What is Azure IoT?
       href: iot-introduction.md
     - name: IoT solution components
       expanded: true
@@ -27,88 +27,100 @@ items:
         href: iot-overview-security.md
       - name: Scalability, high availability
         href: iot-overview-scalability-high-availability.md
-    - name: Choose an Azure IoT service
-      href: iot-services-and-technologies.md
 
-  - name: How-to guides
-    items:
-      - name: Use smartphone device app
-        href: iot-phone-app-how-to.md
-      - name: Use IoT Explorer
-        href: howto-use-iot-explorer.md
-      - name: Connect an on-premises SAP system to Azure
-        href: howto-connect-on-premises-sap-to-azure.md
-      - name: Enable an industrial dataspace in Azure
-        href: howto-iot-industrial-dataspaces.md
+  - name: Choose an Azure IoT service
+    href: iot-services-and-technologies.md
 
-  - name: Tutorials
+  - name: Develop IoT devices
     items:
-    - name: Send telemetry to IoT Hub
+    - name: Overview
+      href: concepts-iot-device-development.md
+    - name: Tutorial - Send telemetry to IoT Hub
       href: tutorial-send-telemetry-iot-hub.md
-    - name: Embedded device development
+    - name: Tutorials - Develop embedded devices
       items:
-        - name: Connect an MXCHIP AZ3166 to IoT Hub
+        - name: Connect MXCHIP AZ3166 to IoT Hub
           href: tutorial-devkit-mxchip-az3166-iot-hub.md
-        - name: Connect an STMicroelectronics B-L475E to IoT Hub
-          href: tutorial-devkit-stm-b-l475e-iot-hub.md
-        - name: Connect an ESPRESSIF ESP32 Kit to IoT Hub
-          href: tutorial-devkit-espressif-esp32-freertos-iot-hub.md
-        - name: Troubleshoot embedded device tutorials
+        - name: Connect STMicroelectronics B-L475E to IoT Hub
+          href: Tutorial-devkit-stm-b-l475e-iot-hub.md
+        - name: Connect ESPRESSIF ESP32 Kit to IoT Hub
+          href: Tutorial-devkit-espressif-esp32-freertos-iot-hub.md
+        - name: Troubleshoot embedded device
           href: troubleshoot-embedded-device-tutorials.md
-    - name: Use MQTT to connect a device
+    - name: IoT device types
+      href: concepts-iot-device-types.md
+    - name: C SDK and Embedded C SDK usage scenarios
+      href: concepts-using-c-sdk-and-embedded-c-sdk.md
+    - name: Manage device reconnections
+      href: concepts-manage-device-reconnections.md
+    - name: IoT device selection
+      href: concepts-iot-device-selection.md
+  - name: Integrate using IoT Plug and Play
+    items:
+    - name: Overview
+      href: overview-iot-plug-and-play.md
+    - name: Architecture
+      href: concepts-architecture.md
+    - name: IoT Plug and Play conventions
+      href: concepts-convention.md
+    - name: IoT Plug and Play message payloads
+      href: concepts-message-payloads.md
+    - name: Device developer guide
+      href: concepts-developer-guide-device.md
+    - name: Service developer guide
+      href: concepts-developer-guide-service.md
+    - name: Digital twins
+      href: concepts-digital-twin.md
+    - name: Device models
+      items:
+      - name: Modeling guide
+        href: concepts-modeling-guide.md
+      - name: Use models in a solution
+        href: concepts-model-discovery.md
+  - name: Communicate using MQTT protocol
+    items:
+    - name: Azure IoT Hub
+      href: iot-mqtt-connect-to-iot-hub.md
+    - name: Azure IoT Device Provisioning Service (DPS) 
+      href: iot-mqtt-connect-to-iot-dps.md
+    - name: Tutorial - Connect a device with MQTT
       href: tutorial-use-mqtt.md
-    - name: Implement the Industrial IoT reference solution
+    
+  - name: Deliver industrial solutions
+    items:
+    - name: Implement industrial IoT reference solution
       href: tutorial-iot-industrial-solution-architecture.md
+    - name: Connect on-premises SAP system to Azure
+      href: howto-connect-on-premises-sap-to-azure.md
+    - name: Enable industrial dataspace in Azure
+      href: howto-iot-industrial-dataspaces.md
 
-  - name: Concepts
+  - name: Connect and test IoT devices
     items:
-      - name: IoT device development
-        items:
-        - name: What is IoT device development
-          href: concepts-iot-device-development.md
-        - name: IoT device types
-          href: concepts-iot-device-types.md
-        - name: C SDK and Embedded C SDK usage scenarios
-          href: concepts-using-c-sdk-and-embedded-c-sdk.md
-        - name: Manage device reconnections
-          href: concepts-manage-device-reconnections.md
-        - name: IoT device selection
-          href: concepts-iot-device-selection.md
-      - name: IoT Plug and Play
-        items:
-        - name: What is IoT Plug and Play?
-          href: overview-iot-plug-and-play.md
-        - name: Architecture
-          href: concepts-architecture.md
-        - name: IoT Plug and Play conventions
-          href: concepts-convention.md
-        - name: IoT Plug and Play message payloads
-          href: concepts-message-payloads.md
-        - name: Device developer guide
-          href: concepts-developer-guide-device.md
-        - name: Service developer guide
-          href: concepts-developer-guide-service.md
-        - name: Digital twins
-          href: concepts-digital-twin.md
-        - name: Device models
-          items:
-          - name: Modeling guide
-            href: concepts-modeling-guide.md
-          - name: Use models in a solution
-            href: concepts-model-discovery.md
-      - name: MQTT support
-        items:
-        - name: Use MQTT with IoT Hub
-          href: iot-mqtt-connect-to-iot-hub.md
-        - name: Use MQTT with DPS
-          href: iot-mqtt-connect-to-iot-dps.md
+    - name: Turn your smartphone into an IoT device
+      href: iot-phone-app-how-to.md
+    - name: Test devices with Azure IoT Explorer
+      href: howto-use-iot-explorer.md
 
-  - name: Resources
+  - name: References
     items:
     - name: Support and help options
       href: iot-support-help.md
     - name: IoT glossary
       href: iot-glossary.md
+    - name: Azure IoT SDKs
+      items:
+      - name: Device and Service SDKs
+        href: iot-sdks.md
+      - name: Azure IoT Operations SDKs
+        href: https://github.com/Azure/iot-operations-sdks
+    - name: Azure IoT Tools for VS Code
+      href: https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit
+    - name: Azure IoT Explorer tool
+      href: https://github.com/Azure/azure-iot-explorer
+
+  - name: Resources
+    items:
     - name: Azure IoT services
       items:
       - name: Azure IoT Operations
@@ -124,15 +136,4 @@ items:
       - name: Azure Maps
         href: ../azure-maps/index.yml
       - name: Time Series Insights
-        href: ../time-series-insights/index.yml
-    - name: Azure IoT SDKs
-      items:
-      - name: Device and Service SDKs
-        href: iot-sdks.md
-      - name: Azure IoT Operations SDKs
-        href: https://github.com/Azure/iot-operations-sdks
-    - name: Azure IoT Tools for VS Code
-      href: https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit
-    - name: Azure IoT Explorer tool
-      href: https://github.com/Azure/azure-iot-explorer
-
+        href: ../time-series-insights/index.yml