Merge pull request #297235 from asergaz/iot-overview-consistency

IoT Overview docs consistency

Author: PMEds28

articles/iot/TOC.yml

@@ -9,15 +9,15 @@ items:
     - name: IoT solution components
       expanded: true
       items:
-      - name: Device development
+      - name: Asset and device development
         href: iot-overview-device-development.md
-      - name: Device connectivity
+      - name: Asset and device connectivity
         href: iot-overview-device-connectivity.md
-      - name: Device management and control
+      - name: Asset and device management and control
         href: iot-overview-device-management.md
       - name: Process and route messages
         href: iot-overview-message-processing.md
-      - name: Extend your IoT solution
+      - name: Extend your solution
         href: iot-overview-solution-extensibility.md
       - name: Analyze and visualize your IoT data
         href: iot-overview-analyze-visualize.md

articles/iot/index.yml

@@ -20,90 +20,143 @@ highlightedContent:
       itemType: overview
       url: ../iot/iot-introduction.md
     # Card
+    - title: What is Azure IoT Operations?
+      itemType: overview
+      url: ../iot-operations/get-started/overview-iot-operations.md
+    # Card
+    - title: Choose an Azure IoT service
+      itemType: how-to-guide
+      url: ../iot/iot-services-and-technologies.md
+    # Card
     - title: Get started with device development on Azure IoT
       itemType: get-started
       url: ../iot/concepts-iot-device-development.md
     # Card
-    - title: Browse Azure IoT code samples
+    - title: Security best practices for IoT solutions
+      itemType: concept
+      url: ../iot/iot-overview-security.md
+    # Card
+    - title: Azure IoT code samples
       itemType: sample
       url: /samples/browse/?term=iot
     # Card
     - title: Azure IoT training
-      itemType: learn
+      itemType: training
       url: /training/browse/?products=azure&term=iot
     # Card
-    - title: Azure IoT reference architecture
-      itemType: architecture
-      url: /azure/architecture/reference-architectures/iot/
-    # Card
     - title: Azure IoT architectures
       itemType: architecture
       url: /azure/architecture/browse/?azure_categories=iot
-    # Card
-    - title: Digital twin definition language (DTDL) models
-      itemType: concept
-      url: ../digital-twins/concepts-models.md
+
+productDirectory:
+  title: IoT services
+  items:
     # Card
     - title: Azure IoT Operations
-      itemType: overview
-      url: ../iot-operations/get-started/overview-iot-operations.md
+      summary: Use Azure IoT Operations to build an edge-based IoT solution that follows the adaptive cloud approach
+      imageSrc: ../media/index/iot-operations.svg
+      url: ../iot-operations/index.yml
+    # Card
+    - title: Azure IoT Hub
+      summary: Use Azure IoT Hub to build a cloud-based IoT solution. IoT Hub doesn't follow the adaptive cloud approach
+      imageSrc: ../media/index/iot-hub.svg
+      url: ../iot-hub/index.yml
+    # Card
+    - title: Azure IoT Central
+      summary: Use Azure IoT Central to build a cloud-based IoT solution. IoT Central doesn't follow the adaptive cloud approach
+      imageSrc: ../media/index/iot-central.svg
+      url: ../iot-central/index.yml
+    # Card
+    - title: Azure Digital Twins
+      summary: The Azure Digital Twins service is typically part of a cloud-based IoT solution that use IoT Hub
+      imageSrc: ../media/index/digital-twins.svg
+      url: ../digital-twins/index.yml
+    # Card
+    - title: Azure IoT Edge
+      summary: IoT Edge is typically part of a hybrid IoT solution that use IoT Hub or IoT Central
+      imageSrc: ../media/index/iot-edge.svg
+      url: ../iot-edge/index.yml
+    # Card
+    - title: Azure Event Grid
+      summary: Currently, Azure Event Grid is typically part of a hybrid IoT solution that uses Azure IoT Operations, IoT Hub, or IoT Central
+      imageSrc: ../media/index/event-grid-domains.svg
+      url: ../event-grid/index.yml
+    # Card
+    - title: Microsoft Defender for IoT
+      summary: Microsoft Defender for IoT is a unified security solution that helps you secure cloud-based, edge-based, and hybrid IoT solutions
+      imageSrc: ../media/index/defender-iot.svg
+      url: ../defender-for-iot/index.yml
+    # Card
+    - title: Windows IoT Enterprise
+      summary: Build intelligent edge solutions with world-class developer tools, long-term support, and enterprise-grade security
+      imageSrc: /media/logos/logo_Windows.svg
+      url: /windows/iot/iot-enterprise/Overview.md
 
 # conceptualContent section
 conceptualContent:
   title: Get started building your IoT solution
-  summary: Azure IoT offers you cloud and edge IoT platforms as well as fully managed IoT solutions
+  summary: Azure IoT offers you services and technologies to build edge-based, cloud-based, and hybrid IoT solutions.
   items:
     # Card
-    - title: Device development
+    - title: Asset and device development
       links:
         - url: ./iot-overview-device-development.md
           itemType: overview
-          text: Introduction to IoT device development
+          text: Introduction to IoT asset and device development
         - url: ./concepts-iot-device-development.md
           itemType: concept
           text: Tools, SDKs, and hardware
         - url: ./tutorial-send-telemetry-iot-hub.md
           itemType: tutorial
-          text: Send telemetry from a device to an Azure IoT hub
+          text: Send sensor data from a device to an Azure IoT hub
         - url: ./iot-sdks.md#device-sdks
           itemType: reference
           text: Device SDKs reference
     # Card
-    - title: Device connectivity
+    - title: Asset and device connectivity
       links:
         - url: ./iot-overview-device-connectivity.md
           itemType: overview
           text: Introduction to IoT asset and device connectivity and infrastructure
+        - url: ../iot-operations/end-to-end-tutorials/tutorial-add-assets.md
+          itemType: tutorial
+          text: Connect OPC UA assets to Azure IoT Operations MQTT broker at the edge
         - url: ../iot/iot-mqtt-connect-to-iot-hub.md
           itemType: concept
           text: MQTT support in Azure IoT Hub
         - url: ../iot-edge/iot-edge-as-gateway.md
           itemType: concept
           text: Use an IoT Edge device as a gateway
     # Card
-    - title: Device management and control
+    - title: Asset and device management and control
       links:
         - url: ./iot-overview-device-management.md
           itemType: overview
-          text: Introduction to device control and management
-        - url: ../iot-dps/about-iot-dps.md
-          itemType: overview
-          text: Device provisioning at scale
+          text: Introduction to IoT asset and device management and control
+        - url: ../iot-operations/discover-manage-assets/overview-manage-assets.md#store-assets-as-azure-resources-in-a-centralized-registry
+          itemType: concept
+          text: Control assets as Azure resources in a centralized registry with Azure IoT Operations
+        - url: https://github.com/Azure/iot-operations-sdks/tree/main
+          itemType: reference
+          text: Command and control with Azure IoT Operations SDKs (preview)
         - url: ../iot-edge/how-to-provision-single-device-linux-symmetric.md
-          itemType: overview
+          itemType: how-to-guide
           text: Create and provision an IoT Edge device
         - url: ../iot-hub-device-update/understand-device-update.md
-          itemType: overview
+          itemType: concept
           text: Update your devices
-        - url: ../firmware-analysis/overview-firmware-analysis.md
-          itemType: overview
-          text: Firmware analysis (preview)
     # Card
     - title: Process and route messages
       links:
         - url: ./iot-overview-message-processing.md
           itemType: overview
           text: Introduction to message processing in an IoT solution
+        - url: ../iot-operations/connect-to-cloud/overview-dataflow.md
+          itemType: concept
+          text: Process and route data with data flows in Azure IoT Operations
+        - url: ../iot-operations/create-edge-apps/edge-apps-overview.md
+          itemType: concept
+          text: Develop highly available applications for Azure IoT Operations MQTT broker
         - url: ../iot-hub/iot-hub-devguide-messages-d2c.md
           itemType: concept
           text: IoT Hub message routing
@@ -116,21 +169,22 @@ conceptualContent:
         - url: ./iot-overview-solution-extensibility.md
           itemType: overview
           text: Introduction to Azure IoT extensibility options
+        - url: ../iot-operations/connect-to-cloud/howto-configure-fabric-real-time-intelligence.md
+          itemType: how-to-guide
+          text: Configure data flow endpoints for Microsoft Fabric Real-Time Intelligence
         - url: ../iot/iot-sdks.md#iot-hub-service-sdks
           itemType: reference
           text: Service SDKs
-        - url: /azure/architecture/browse/?azure_categories=iot
-          itemType: architecture
-          text: Azure IoT architectures
     # Card
     - title: Analyze and visualize IoT data
       links:
         - url: ./iot-overview-analyze-visualize.md
           itemType: overview
           text: Introduction to analyzing and visualizing your IoT data
-        - url: ../digital-twins/overview.md
-          itemType: overview
-          text: Azure Digital Twins
-        - url: ../iot-central/core/howto-create-analytics.md
+        - url: ../iot-operations/end-to-end-tutorials/tutorial-get-insights.md
+          itemType: tutorial
+          text: Get insights from your processed data in Azure IoT Operations
+        - url: ../iot-hub/iot-hub-live-data-visualization-in-power-bi.md
           itemType: how-to-guide
-          text: Use IoT Central data explorer to analyze device data
+          text: Visualize real-time sensor data from IoT Hub using Power BI
+  

articles/iot/iot-overview-analyze-visualize.md

@@ -19,13 +19,13 @@ In Azure IoT, analysis and visualization services are used to identify and displ
 
 # [Edge-based solution](#tab/edge)
 
-The following diagram shows a high-level view of the components in a typical edge-based IoT solution. This article focuses on the areas relevant to analyzing and visualizing your IoT data:
+The following diagram shows a high-level view of the components in a typical [edge-based IoT solution](iot-introduction.md#edge-based-solution). This article focuses on the areas relevant to analyzing and visualizing your IoT data:
 
 :::image type="content" source="media/iot-overview-analyze-visualize/iot-edge-visualization-architecture.svg" alt-text="Diagram that shows the high-level IoT solution architecture highlighting solution visualization areas." border="false":::
 
 # [Cloud-based solution](#tab/cloud)
 
-The following diagram shows a high-level view of the components in a typical cloud-based IoT solution. This article focuses on the areas relevant to analyzing and visualizing your IoT data:
+The following diagram shows a high-level view of the components in a typical [cloud-based IoT solution](iot-introduction.md#cloud-based-solution). This article focuses on the areas relevant to analyzing and visualizing your IoT data:
 
 :::image type="content" source="media/iot-overview-analyze-visualize/iot-cloud-visualization-architecture.svg" alt-text="Diagram that shows the high-level IoT solution architecture highlighting solution visualization areas." border="false":::
 
@@ -100,3 +100,9 @@ Azure Stream Analytics is a fully managed stream processing engine that is desig
 ### Azure Maps
 
 [Azure Maps](../azure-maps/about-azure-maps.md) is a collection of geospatial services and SDKs that use fresh mapping data to provide geographic context to web and mobile applications. For an IoT example, see [Integrate with Azure Maps (Azure Digital Twins)](../digital-twins/how-to-integrate-maps.md).
+
+## Related content
+
+- [Message processing in an IoT solution](iot-overview-message-processing.md)
+- [Extend your IoT solution](iot-overview-solution-extensibility.md)
+- [Choose an Azure IoT service](iot-services-and-technologies.md)

articles/iot/iot-overview-device-connectivity.md

@@ -16,14 +16,14 @@ This overview introduces the key concepts around how assets and devices connect
 
 ### [Edge-based solution](#tab/edge)
 
-The following diagram shows a high-level view of the components in a typical edge-based IoT solution. This article focuses on the connectivity between the assets and the edge runtime environment shown in the diagram:
+The following diagram shows a high-level view of the components in a typical [edge-based IoT solution](iot-introduction.md#edge-based-solution). This article focuses on the connectivity between the assets and the edge runtime environment shown in the diagram:
 
 <!-- Art Library Source# ConceptArt-0-000-032 -->
 :::image type="content" source="media/iot-overview-device-connectivity/iot-edge-connectivity-architecture.svg" alt-text="Diagram that shows the high-level IoT edge-based solution architecture highlighting device connectivity areas." border="false" lightbox="media/iot-overview-device-connectivity/iot-edge-connectivity-architecture.svg":::
 
 ### [Cloud-based solution](#tab/cloud)
 
-The following diagram shows a high-level view of the components in a typical cloud-based IoT solution. This article focuses on the connectivity between the devices and the IoT cloud services, including gateways and bridges shown in the diagram:
+The following diagram shows a high-level view of the components in a typical [cloud-based IoT solution](iot-introduction.md#cloud-based-solution). This article focuses on the connectivity between the devices and the IoT cloud services, including gateways and bridges shown in the diagram:
 
 <!-- Art Library Source# ConceptArt-0-000-032 -->
 :::image type="content" source="media/iot-overview-device-connectivity/iot-cloud-connectivity-architecture.svg" alt-text="Diagram that shows the high-level IoT cloud-based solution architecture highlighting device connectivity areas." border="false" lightbox="media/iot-overview-device-connectivity/iot-cloud-connectivity-architecture.svg":::
@@ -226,9 +226,8 @@ A device bridge enables devices that are connected to a non-Microsoft cloud to c
 The open source IoT Central Device Bridge acts as a translator that forwards device data to an IoT Central application. To learn more, see [Azure IoT Central Device Bridge](https://github.com/Azure/iotc-device-bridge). There are non-Microsoft bridge solutions, such as [Tartabit IoT Bridge](/shows/internet-of-things-show/onboarding-constrained-devices-into-azure-using-tartabits-iot-bridge), for connecting devices to an IoT hub.
 
 
-## Next steps
-
-Now that you've seen an overview of device connectivity in Azure IoT solutions, some suggested next steps include:
+## Related content
 
+- [IoT asset and device development](iot-overview-device-development.md)
 - [IoT asset and device management and control](iot-overview-device-management.md)
-- [Process and route messages](iot-overview-message-processing.md)
+- [Choose an Azure IoT service](iot-services-and-technologies.md)