Merge pull request #310329 from cwatson-cat/1-9-26-iot-gen-2-toc

IoT Hub - ADR & cert man TOC [For FEB 23 release of related PR]

Author: Stacyrch140

articles/iot-hub/TOC.yml

@@ -1,36 +1,34 @@
 - name: IoT Hub documentation
   href: index.yml
 - name: Overview
+  expanded: true
   items:
     - name: What is IoT Hub?
       href: iot-concepts-and-iot-hub.md
-- name: What's new (Preview)?
-  items:
-    - name: Overview
+    - name: What's new?
       href: iot-hub-what-is-new.md
     - name: Frequently asked questions
       href: iot-hub-faq.md
-    - name: Integration with Azure Device Registry (Preview)
-      href: iot-hub-device-registry-overview.md
-    - name: Certificate management (Preview)
-      items:
-        - name: Overview
-          href: iot-hub-certificate-management-overview.md
-        - name: Key concepts for certificate management
-          href: iot-hub-certificate-management-concepts.md
-    - name: Get started with IoT Hub (Preview)
-      href: iot-hub-device-registry-setup.md
-  expanded: true
 - name: Quickstarts
+  expanded: true
   items:
+    - name: Get started (ADR integration)
+      href: iot-hub-device-registry-setup.md
     - name: Create an IoT hub (no ADR integration)
       href: create-hub.md
       displayName: create IoT Hub, delete IoT hub, portal, CLI
     - name: Send telemetry using CLI
       href: quickstart-send-telemetry-cli.md
       displayName: Azure CLI
 - name: Concepts
+  expanded: true
   items: 
+    - name: Azure Device Registry integration (preview)
+      href: iot-hub-device-registry-overview.md
+    - name: Certificate management (preview)
+      href: iot-hub-certificate-management-overview.md
+    - name: Key concepts for certificate management
+      href: iot-hub-certificate-management-concepts.md
     - name: Understand IoT Hub endpoints
       href: iot-hub-devguide-endpoints.md
       displayName: multitenant

articles/iot-hub/iot-hub-certificate-management-concepts.md

@@ -70,4 +70,8 @@ In certificate management, devices submit CSRs during provisioning or reprovisio
 
 X.509 certificates are only used for authentication in IoT Hub, not authorization. Unlike with [Microsoft Entra ID](authenticate-authorize-azure-ad.md) and [shared access signatures](authenticate-authorize-sas.md), you can't customize permissions with X.509 certificates.
 
+## Related content
 
+- [What is Microsoft-backed X.509 certificate management?](iot-hub-certificate-management-overview.md)
+- [Integration with Azure Device Registry](iot-hub-device-registry-overview.md)
+- [Get started with ADR and certificate management in IoT Hub](iot-hub-device-registry-setup.md)

articles/iot-hub/iot-hub-certificate-management-overview.md

@@ -110,3 +110,9 @@ Certificate management doesn't support certificate revocation during public prev
 
 See [Azure subscription and service limits](../azure-resource-manager/management/azure-subscription-service-limits.md#azure-iot-hub-limits) for the latest information about limits and quotas for certificate management with IoT Hub.
 
+## Related content
+
+- [FAQ: What is new in Azure IoT Hub?](iot-hub-faq.md)
+- [Key concepts for certificate management](iot-hub-certificate-management-concepts.md)
+- [Get started with ADR and certificate management in IoT Hub](iot-hub-device-registry-setup.md)
+- [Integration with Azure Device Registry](iot-hub-device-registry-overview.md)

articles/iot-hub/iot-hub-device-registry-overview.md

@@ -53,3 +53,9 @@ See [IoT Hub preview resource limits](../azure-resource-manager/management/azure
 
 For Azure subscription and service limits for Azure Device Registry in GA, see [Azure Device Registry limits](../azure-resource-manager/management/azure-subscription-service-limits.md#azure-device-registry-limits).
 
+## Related content
+
+- [FAQ: What is new in Azure IoT Hub?](iot-hub-faq.md)
+- [Get started with ADR and certificate management in IoT Hub](iot-hub-device-registry-setup.md)
+- [What is Microsoft-backed X.509 certificate management?](iot-hub-certificate-management-overview.md)
+- [Key concepts for certificate management](iot-hub-certificate-management-concepts.md)

articles/iot-hub/iot-hub-faq.md

@@ -72,4 +72,11 @@ IoT Hub with ADR integration and certificate management is available in the foll
 - West US
 - West US 2
 - West Europe
-- North Europe
+- North Europe
+
+## Related content
+
+- [Integration with Azure Device Registry](iot-hub-device-registry-overview.md)
+- [What is Microsoft-backed X.509 certificate management?](iot-hub-certificate-management-overview.md)
+- [Key concepts for certificate management](iot-hub-certificate-management-concepts.md)
+- [Get started with ADR and certificate management in IoT Hub](iot-hub-device-registry-setup.md)

articles/iot-hub/iot-hub-what-is-new.md

@@ -2,19 +2,21 @@
 title: What is New in Azure IoT Hub? (Preview)
 titleSuffix: Azure IoT Hub
 description: This article explains the new features and improvements in Azure IoT Hub.
+#customer intent: As a developer new to IoT Hub, I want to understand the new features and improvements in Azure IoT Hub so that I can evaluate their benefits for my IoT projects.
 author: cwatson-cat
 ms.author: cwatson
+ms.reviewer: cwatson
 ms.service: azure-iot-hub
 services: iot-hub
 ms.topic: overview
 ms.date: 01/27/2025
 ms.custom: references_regions
-#Customer intent: As a developer new to IoT Hub, I want to understand the new features and improvements in Azure IoT Hub.
+ai-usage: ai-assisted
 ---
 
 # What is new in Azure IoT Hub? (preview)
 
-Starting November 2025, Azure IoT Hub introduces two new **preview** features: integration with Azure Device Registry (ADR) and enhanced Microsoft-backed X.509 certificate management. These features are designed to improve security, simplify device management, and streamline operations for IoT deployments.
+Starting November 2025, Azure IoT Hub introduces two new **preview** features: integration with Azure Device Registry (ADR) and enhanced Microsoft-backed X.509 certificate management. These features help improve security, simplify device management, and streamline operations for IoT deployments. This article provides an overview of both features and how to get started.
 
 [!INCLUDE [iot-hub-public-preview-banner](includes/public-preview-banner.md)]
 
@@ -26,15 +28,15 @@ For more information, see [What is Azure Device Registry?](iot-hub-device-regist
 
 ## Manage your X.509 credentials with certificate management
 
-IoT Hub now introduces certificate management for managing device certificates using Microsoft-managed public key infrastructure (PKI) with X.509 certificates. Certificate management is an optional feature of ADR that enables you to issue and manage X.509 certificates for your IoT devices. It configures a dedicated, cloud-based PKI for each of your ADR namespaces, without requiring any on-premises servers, connectors, or hardware. It handles the certificate of issuance and renewal for all IoT devices that have been provisioned to that ADR namespace. These X.509 certificates can be used for your IoT devices to authenticate with IoT Hub.
+IoT Hub now introduces certificate management for managing device certificates by using Microsoft-managed public key infrastructure (PKI) with X.509 certificates. Certificate management is an optional feature of ADR that enables you to issue and manage X.509 certificates for your IoT devices. It configures a dedicated, cloud-based PKI for each of your ADR namespaces, without requiring any on-premises servers, connectors, or hardware. It handles the certificate of issuance and renewal for all IoT devices that are provisioned to that ADR namespace. These X.509 certificates can be used for your IoT devices to authenticate with IoT Hub.
 
-These X.509 certificates are strictly operational certificates that the device uses to authenticate with IoT Hub for secure communications, after the device has onboarded with a different credential. 
+These X.509 certificates are strictly operational certificates that the device uses to authenticate with IoT Hub for secure communications, after the device is onboarded with a different credential.  
 
 To use certificate management, devices must be provisioned through [Azure IoT Hub Device Provisioning Service (DPS)](../iot-dps/index.yml). 
 
 For more information, see [What is certificate management?](iot-hub-certificate-management-overview.md) and [Key concepts for certificate management](iot-hub-certificate-management-concepts.md).
 
-## Device Provisioning Service requirement
+## Understand Device Provisioning Service requirement
 
 All Azure IoT Hub preview scenarios require Device Provisioning Service (DPS). You must link your IoT Hub to a DPS instance and provision devices through DPS, whether you use certificate management or not. DPS enables consistent device onboarding, identity assignment, and secure authentication with IoT Hub.
 
@@ -51,9 +53,22 @@ To use IoT Hub with Azure Device Registry and certificate management, deploy ins
 - West Europe
 - North Europe
 
-## Next steps
+## Get started with ADR and certificate management
 
-To learn more about using Azure Device Registry and certificate management in IoT Hub, complete the following guide:
+To use these preview features, you must create a new IoT Hub instance with ADR integration. There's currently no upgrade path for existing IoT Hubs. If you're using IoT Hub now, your existing hubs continue to work without interruption. To try the new features, you'll need to:
 
-> [!div class="nextstepaction"]
-> [Get started with ADR and certificate management in IoT Hub](iot-hub-device-registry-setup.md)
+1. Create a new ADR namespace or link to an existing one.
+1. Create a new IoT Hub and connect it to your ADR namespace.
+1. If you want to use certificate management, link your IoT Hub to a DPS instance.
+
+For more information, see [Get started with ADR and certificate management in IoT Hub](iot-hub-device-registry-setup.md).
+
+The preview period offers these features at no extra cost on top of your standard IoT Hub pricing.
+
+## Related content
+
+- [FAQ: What is new in Azure IoT Hub?](iot-hub-faq.md)
+- [Integration with Azure Device Registry](iot-hub-device-registry-overview.md)
+- [What is Microsoft-backed X.509 certificate management?](iot-hub-certificate-management-overview.md)
+- [Key concepts for certificate management](iot-hub-certificate-management-concepts.md)
+- [Get started with ADR and certificate management in IoT Hub](iot-hub-device-registry-setup.md)