Merge pull request #215367 from PatAltimore/patricka-supported-platforms

Move support TOC entry, Clarify intro

Author: denrea

articles/iot-edge/TOC.yml

@@ -1,84 +1,14 @@
 - name: Azure IoT Edge documentation
   href: index.yml
-- name: Azure IoT Edge for Linux on Windows (EFLOW)
-  expanded: false
-  items:
-  - name: About EFLOW
-    href: iot-edge-for-linux-on-windows.md
-  - name: Deploy to a Windows device
-    href: quickstart.md
-  - name: Concepts
-    items:
-    - name: Benefits
-      href: iot-edge-for-linux-on-windows-benefits.md
-    - name: Updates
-      href: iot-edge-for-linux-on-windows-updates.md
-    - name: Security
-      href: iot-edge-for-linux-on-windows-security.md
-    - name: Networking
-      href: iot-edge-for-linux-on-windows-networking.md
-    - name: Platform support
-      href: iot-edge-for-linux-on-windows-support.md
-  - name: Install and provision
-    items:
-    - name: Single device
-      items:
-      - name: X.509 certificate attestation
-        href: how-to-provision-single-device-linux-on-windows-x509.md
-      - name: Symmetric key attestation
-        href: how-to-provision-single-device-linux-on-windows-symmetric.md
-    - name: Provision at scale
-      items:
-      - name: X.509 certificate attestation
-        href: how-to-provision-devices-at-scale-linux-on-windows-x509.md
-      - name: TPM attestation
-        href: how-to-provision-devices-at-scale-linux-on-windows-tpm.md
-      - name: Symmetric key attestation
-        href: how-to-provision-devices-at-scale-linux-on-windows-symmetric.md
-  - name: Configure
-    items:
-    - name: Networking
-      items:
-      - name: Understand VM networking
-        href: how-to-configure-iot-edge-for-linux-on-windows-networking.md
-      - name: Virtual switch
-        href: how-to-create-virtual-switch.md
-      - name: Multiple NICs
-        href: how-to-configure-multiple-nics.md
-      - name: VM on a DMZ
-        href: how-to-configure-iot-edge-for-linux-on-windows-iiot-dmz.md
-    - name: Configure nested virtualization for Windows VMs
-      href: nested-virtualization.md
-    - name: Access TPM secrets
-      href: how-to-access-dtpm.md
-    - name: GPU acceleration
-      href: gpu-acceleration.md
-    - name: Shared folders
-      href: how-to-share-windows-folder-to-vm.md
-    - name: Connect a USB device
-      href: how-to-connect-usb-devices.md
-  - name: Develop and debugging
-    href: tutorial-develop-for-linux-on-windows.md
-  - name: Create a hierarchy of IoT Edge devices
-    href: tutorial-nested-iot-edge-for-linux-on-windows.md
-  - name: Troubleshoot
-    items:
-    - name: Diagnose virtual machine
-      href: troubleshoot-iot-edge-for-linux-on-windows.md
-    - name: Diagnose virtual machine networking
-      href: troubleshoot-iot-edge-for-linux-on-windows-networking.md
-    - name: Resolve common errors
-      href: troubleshoot-iot-edge-for-linux-on-windows-common-errors.md
-  - name: Reference
-    items:
-    - name: PowerShell functions
-      href: reference-iot-edge-for-linux-on-windows-functions.md
-- name: Azure IoT Edge versions
-  href: version-history.md
 - name: Overview
+  expanded: true
   items:
   - name: About Azure IoT Edge
     href: about-iot-edge.md
+  - name: Version / release notes
+    href: version-history.md
+  - name: Supported platforms
+    href: support.md
 - name: Quickstarts
   expanded: true
   items:
@@ -182,8 +112,6 @@
       href: iot-edge-certs.md
     - name: Confidential computing
       href: deploy-confidential-applications.md
-  - name: Platform support
-    href: support.md
   - name: Production deployment checklist
     href: production-checklist.md
   - name: Limits and restrictions
@@ -343,6 +271,79 @@
       href: troubleshoot-in-portal.md
     - name: Resolve common errors
       href: troubleshoot-common-errors.md
+- name: Azure IoT Edge for Linux on Windows (EFLOW)
+  expanded: false
+  items:
+  - name: About EFLOW
+    href: iot-edge-for-linux-on-windows.md
+  - name: Deploy to a Windows device
+    href: quickstart.md
+  - name: Concepts
+    items:
+    - name: Benefits
+      href: iot-edge-for-linux-on-windows-benefits.md
+    - name: Updates
+      href: iot-edge-for-linux-on-windows-updates.md
+    - name: Security
+      href: iot-edge-for-linux-on-windows-security.md
+    - name: Networking
+      href: iot-edge-for-linux-on-windows-networking.md
+    - name: Supported platforms
+      href: iot-edge-for-linux-on-windows-support.md
+  - name: Install and provision
+    items:
+    - name: Single device
+      items:
+      - name: X.509 certificate attestation
+        href: how-to-provision-single-device-linux-on-windows-x509.md
+      - name: Symmetric key attestation
+        href: how-to-provision-single-device-linux-on-windows-symmetric.md
+    - name: Provision at scale
+      items:
+      - name: X.509 certificate attestation
+        href: how-to-provision-devices-at-scale-linux-on-windows-x509.md
+      - name: TPM attestation
+        href: how-to-provision-devices-at-scale-linux-on-windows-tpm.md
+      - name: Symmetric key attestation
+        href: how-to-provision-devices-at-scale-linux-on-windows-symmetric.md
+  - name: Configure
+    items:
+    - name: Networking
+      items:
+      - name: Understand VM networking
+        href: how-to-configure-iot-edge-for-linux-on-windows-networking.md
+      - name: Virtual switch
+        href: how-to-create-virtual-switch.md
+      - name: Multiple NICs
+        href: how-to-configure-multiple-nics.md
+      - name: VM on a DMZ
+        href: how-to-configure-iot-edge-for-linux-on-windows-iiot-dmz.md
+    - name: Configure nested virtualization for Windows VMs
+      href: nested-virtualization.md
+    - name: Access TPM secrets
+      href: how-to-access-dtpm.md
+    - name: GPU acceleration
+      href: gpu-acceleration.md
+    - name: Shared folders
+      href: how-to-share-windows-folder-to-vm.md
+    - name: Connect a USB device
+      href: how-to-connect-usb-devices.md
+  - name: Develop and debugging
+    href: tutorial-develop-for-linux-on-windows.md
+  - name: Create a hierarchy of IoT Edge devices
+    href: tutorial-nested-iot-edge-for-linux-on-windows.md
+  - name: Troubleshoot
+    items:
+    - name: Diagnose virtual machine
+      href: troubleshoot-iot-edge-for-linux-on-windows.md
+    - name: Diagnose virtual machine networking
+      href: troubleshoot-iot-edge-for-linux-on-windows-networking.md
+    - name: Resolve common errors
+      href: troubleshoot-iot-edge-for-linux-on-windows-common-errors.md
+  - name: Reference
+    items:
+    - name: PowerShell functions
+      href: reference-iot-edge-for-linux-on-windows-functions.md
 - name: Reference
   items:
   - name: Runtime modules environment variables

articles/iot-edge/support.md

@@ -1,6 +1,6 @@
 ---
-title: Supported operating systems, container engines - Azure IoT Edge
-description: Learn which operating systems can run the Azure IoT Edge daemon and runtime, and supported container engines for your production devices
+title: IoT Edge supported platforms
+description: Azure IoT Edge supported operating systems, runtimes, and container engines.
 author: PatAltimore
 ms.author: patricka
 ms.date: 02/08/2022
@@ -9,21 +9,21 @@ ms.service: iot-edge
 services: iot-edge
 ---
 
-# Azure IoT Edge supported systems
+# Azure IoT Edge supported platforms
 
 [!INCLUDE [iot-edge-version-1.1-or-1.4](./includes/iot-edge-version-1.1-or-1.4.md)]
 
-This article provides details about which systems and components are supported by IoT Edge, whether officially or in preview.
+This article explains what operating system platforms, IoT Edge runtimes, container engines, and components are supported by IoT Edge whether generally available or in preview.
 
 ## Get support
 
 If you experience problems while using the Azure IoT Edge service, there are several ways to seek support. Try one of the following channels for support:
 
-**Reporting bugs** – Most development that goes into the Azure IoT Edge product happens in the IoT Edge open-source project. Bugs can be reported on the [issues page](https://github.com/azure/iotedge/issues) of the project. Bugs related to Azure IoT Edge for Linux on Windows can be reported on the [iotedge-eflow issues page](https://github.com/azure/iotedge-eflow/issues). Fixes rapidly make their way from the projects in to product updates.
+**Reporting bugs** - Most development that goes into the Azure IoT Edge product happens in the IoT Edge open-source project. Bugs can be reported on the [issues page](https://github.com/azure/iotedge/issues) of the project. Bugs related to Azure IoT Edge for Linux on Windows can be reported on the [iotedge-eflow issues page](https://github.com/azure/iotedge-eflow/issues). Fixes rapidly make their way from the projects in to product updates.
 
-**Microsoft Customer Support team** – Users who have a [support plan](https://azure.microsoft.com/support/plans/) can engage the Microsoft Customer Support team by creating a support ticket directly from the [Azure portal](https://portal.azure.com/signin/index/?feature.settingsportalinstance=mpac).
+**Microsoft Customer Support team** - Users who have a [support plan](https://azure.microsoft.com/support/plans/) can engage the Microsoft Customer Support team by creating a support ticket directly from the [Azure portal](https://portal.azure.com/signin/index/?feature.settingsportalinstance=mpac).
 
-**Feature requests** – The Azure IoT Edge product tracks feature requests via the product's [User Voice page](https://feedback.azure.com/d365community/forum/0e2fff5d-f524-ec11-b6e6-000d3a4f0da0).
+**Feature requests** - The Azure IoT Edge product tracks feature requests via the product's [User Voice page](https://feedback.azure.com/d365community/forum/0e2fff5d-f524-ec11-b6e6-000d3a4f0da0).
 
 ## Container engines
 
@@ -170,30 +170,17 @@ The systems listed in the following table are considered compatible with Azure I
 
 ## Releases
 
-IoT Edge release assets and release notes are available on the [azure-iotedge releases](https://github.com/Azure/azure-iotedge/releases) page. This section reflects information from those release notes to help you visualize the components of each version more easily.
+The following table lists the currently supported releases. IoT Edge release assets and release notes are available on the [azure-iotedge releases](https://github.com/Azure/azure-iotedge/releases) page.
 
-The following table lists the components included in each release starting with 1.2.0. The components listed in this table can be installed or updated individually, and are backwards compatible with older versions.
+| Release notes and assets | Type | Release Date | End of Support Date |
+| ------------------------ | ---- | ------------ | ------------------- |
+| [1.4](https://github.com/Azure/azure-iotedge/releases/tag/1.4.0) | Long-term support (LTS) | August 2022 | November 12, 2024 |
+| [1.1](https://github.com/Azure/azure-iotedge/releases/tag/1.1.0) | Long-term support (LTS) | February 2021 | December 13, 2022 |
 
-| Release | aziot-edge | edgeHub<br>edgeAgent | aziot-identity-service |
-| ------- | ---------- | -------------------- | ---------------------- |
-| **1.4** | 1.4.0      | 1.4.0                | 1.4.0                  |
-| **1.3** | 1.3.0      | 1.3.0                | 1.3.0                  |
-| **1.2** | 1.2.0<br>1.2.1<br>1.2.3<br>1.2.4<br>1.2.5<br><br>1.2.7 | 1.2.0<br>1.2.1<br>1.2.3<br>1.2.4<br>1.2.5<br>1.2.6<br>1.2.7 | 1.2.0<br>1.2.1<br>1.2.3<br>1.2.4<br>1.2.5<br> |
-
-The following table lists the components included in each release up to the 1.1 LTS release. The components listed in this table can be installed or updated individually, and are backwards compatible with older versions.
+For more information on IoT Edge version history see, [Version history](version-history.md#version-history).
 
 IoT Edge 1.1 is the first long-term support (LTS) release channel. This version introduced no new features, but will receive security updates and fixes to regressions. IoT Edge 1.1 LTS uses .NET Core 3.1, and will be supported until December 13, 2022 to match the [.NET Core and .NET 5 release lifecycle](https://dotnet.microsoft.com/platform/support/policy/dotnet-core).
 
-| Release | iotedge | edgeHub<br>edgeAgent | libiothsm | moby |
-|--|--|--|--|--|
-| **1.1 LTS** | 1.1.0<br>1.1.1<br><br>1.1.3<br>1.1.4<br>1.1.5<br>1.1.6 | 1.1.0<br>1.1.1<br>1.1.2<br>1.1.3<br>1.1.4<br>1.1.5<br><br> | 1.1.0<br>1.1.1<br><br>1.1.3<br>1.1.4<br>1.1.5<br>1.1.6 |   |
-| **1.0.10** | 1.0.10<br>1.0.10.1<br>1.0.10.2<br><br>1.0.10.4 | 1.0.10<br>1.0.10.1<br>1.0.10.2<br>1.0.10.3<br>1.0.10.4 | 1.0.10<br>1.0.10.1<br>1.0.10.2<br><br>1.0.10.4 |  |
-| **1.0.9** | 1.0.9<br>1.0.9.1<br>1.0.9.2<br>1.0.9.3<br>1.0.9.4<br>1.0.9.5 | 1.0.9<br>1.0.9.1<br>1.0.9.2<br>1.0.9.3<br>1.0.9.4<br>1.0.9.5 | 1.0.9<br>1.0.9.1<br>1.0.9.2<br>1.0.9.3<br>1.0.9.4<br>1.0.9.5 |  |
-| **1.0.8** | 1.0.8 | 1.0.8<br>1.0.8.1<br>1.0.8.2<br>1.0.8.3<br>1.0.8.4<br>1.0.8.5 | 1.0.8 | 3.0.6 |
-| **1.0.7** | 1.0.7<br>1.0.7.1 | 1.0.7<br>1.0.7.1 | 1.0.7<br>1.0.7.1 | 3.0.4 (ARMv7hl, CentOS)<br>3.0.5 |
-| **1.0.6** | 1.0.6<br>1.0.6.1 | 1.0.6<br>1.0.6.1 | 1.0.6<br>1.0.6.1 |  |
-| **1.0.5** | 1.0.5 | 1.0.5 | 1.0.5 | 3.0.2 |
-
 > [!IMPORTANT]
 > * Every Microsoft product has a lifecycle. The lifecycle begins when a product is released and ends when it's no longer supported. Knowing key dates in this lifecycle helps you make informed decisions about when to upgrade or make other changes to your software. IoT Edge is governed by Microsoft's [Modern Lifecycle Policy](/lifecycle/policies/modern).
 > * With the release of a long-term support channel, we recommend that all current customers running 1.0.x upgrade their devices to 1.1.x to receive ongoing support.
@@ -202,7 +189,9 @@ IoT Edge uses the Microsoft.Azure.Devices.Client SDK. For more information, see
 
 | IoT Edge version | Microsoft.Azure.Devices.Client SDK version |
 |------------------|--------------------------------------------|
-| 1.2.0            | 1.33.4-NestedEdge
+| 1.4              | 1.36.6                                     |
+| 1.3              | 1.36.6                                     |
+| 1.2.0            | 1.33.4-NestedEdge                          |
 | 1.1 (LTS)        | 1.28.0                                     |
 | 1.0.10           | 1.28.0                                     |
 | 1.0.9            | 1.21.1                                     |

articles/iot-edge/version-history.md

@@ -1,6 +1,6 @@
 ---
-title: IoT Edge version navigation and history - Azure IoT Edge
-description: Discover what's new in IoT Edge with information about new features and capabilities in the latest releases.
+title: IoT Edge version history and release notes
+description: Release history and notes for IoT Edge.
 author: PatAltimore
 ms.author: patricka
 ms.date: 08/25/2022