Merge pull request #303498 from dominicbetts/release-aio-2507-aep-message

AIO 2507: Refine AEP wording

Author: ttorble

articles/iot-operations/discover-manage-assets/concept-assets-devices.md

@@ -12,8 +12,10 @@ ms.date: 06/24/2025
 
 # Define assets and devices
 
-[!INCLUDE [assets-devices-logical-entities](../includes/assets-devices-logical-entities.md)]
+> [!IMPORTANT]
+> Devices (preview) are new in version 1.2.x of Azure IoT Operations. To view the asset endpoint documentation, see [Asset management overview](/previous-versions/azure/iot-operations/discover-manage-assets/overview-manage-assets) on the previous versions site.
 
+[!INCLUDE [assets-devices-logical-entities](../includes/assets-devices-logical-entities.md)]
 
 :::image type="content" source="media/concept-assets-devices/assets-devices.svg" alt-text="Diagram that shows the relationships between the asset and device configuration resources." border="false":::
 

articles/iot-operations/discover-manage-assets/overview-manage-assets.md

@@ -12,6 +12,9 @@ ai-usage: ai-assisted
 
 # What is asset and device management in Azure IoT Operations?
 
+> [!IMPORTANT]
+> Devices (preview) are new in version 1.2.x of Azure IoT Operations. To view the asset endpoint documentation, see [Asset management overview](/previous-versions/azure/iot-operations/discover-manage-assets/overview-manage-assets) on the previous versions site.
+
 In Azure IoT Operations, a key task is to manage the assets and devices that are part of your solution. This article:
 
 - Defines what *namespace assets (preview)* and *devices (preview)* are in the context of Azure IoT Operations.
@@ -72,9 +75,6 @@ An operator configures and manages devices and namespace assets in the operation
 
 To learn more, see [Define assets and devices](concept-assets-devices.md).
 
-> [!TIP]
-> Devices replace the asset endpoints from previous versions of Azure IoT Operations. To view the asset endpoint documentation, see [Asset management overview](https://go.microsoft.com/fwlink/?linkid=2328508&clcid=0x409) on the previous versions site.
-
 ## Understand services for managing devices and namespace assets
 
 Azure IoT Operations includes several services that help you manage devices and assets.

articles/iot-operations/toc.yml

@@ -77,6 +77,9 @@ items:
       - name: Use the operations experience UI
         href: discover-manage-assets/howto-manage-assets-devices.md
         displayName: operations, experience, site, instance, device, data points, events, CLI, kubectl, southbound
+      - name: Use asset endpoints to manage assets
+        href: /previous-versions/azure/iot-operations/discover-manage-assets/overview-manage-assets
+        displayName: connector, tags, southbound, asset endpoint profile
       - name: Connect to OPC UA servers
         items:
         - name: Understand the connector for OPC UA