Re-order articles

Author: dominicbetts

articles/iot-operations/manage-devices-assets/howto-manage-assets-remotely.md

@@ -28,8 +28,8 @@ In the Azure IoT Operations (preview) portal, an _instance_ represents an Azure
 
 This article describes how to use the Azure IoT Operations (preview) portal and the Azure CLI to:
 
-- Define asset endpoints
-- Add assets, and define tags and events
+- Define the asset endpoints that connect assets to your Azure IoT Operations instance.
+- Add assets, and define their tags and events to enable data flow from OPC UA servers to the Azure IoT MQ broker.
 
 These assets, tags, and events map inbound data from OPC UA servers to friendly names that you can use in the MQ broker and Azure IoT Data Processor Preview pipelines.
 
@@ -124,7 +124,7 @@ The previous example uses the `Anonymous` authentication mode. This mode doesn't
 
 To use the `UsernamePassword` authentication mode, complete the following steps:
 
-1. Follow the steps in [Configure OPC UA user authentication with username and password](howto-configure-opcua-authentication-options.md#configure-opc-ua-user-authentication-with-username-and-password) to add secrets for username and password in Azure Key Vault, and project them into Kubernetes cluster.
+1. Follow the steps in [Configure OPC UA user authentication with username and password](howto-configure-opcua-authentication-options.md#configure-username-and-password-authentication) to add secrets for username and password in Azure Key Vault, and project them into Kubernetes cluster.
 2. In the Azure IoT Operations (preview) portal, select **Username & password** for the **User authentication** field to configure the asset endpoint to use these secrets. Then enter the following values for the **Username reference** and **Password reference** fields:
 
 | Field | Value |
@@ -136,7 +136,7 @@ To use the `UsernamePassword` authentication mode, complete the following steps:
 
 To use the `UsernamePassword` authentication mode, complete the following steps:
 
-1. Follow the steps in [Configure OPC UA user authentication with username and password](howto-configure-opcua-authentication-options.md#configure-opc-ua-user-authentication-with-username-and-password) to add secrets for username and password in Azure Key Vault, and project them into Kubernetes cluster.
+1. Follow the steps in [Configure OPC UA user authentication with username and password](howto-configure-opcua-authentication-options.md#configure-username-and-password-authentication) to add secrets for username and password in Azure Key Vault, and project them into Kubernetes cluster.
 
 1. Use a command like the following example to create your asset endpoint:
 
@@ -152,12 +152,12 @@ To configure the asset endpoint to use a transport authentication certificate, c
 
 # [Azure IoT Operations portal](#tab/portal)
 
-1. Follow the steps in [configure mutual trust](howto-configure-opcua-certificates-infrastructure.md#how-to-handle-the-opc-ua-trusted-certificates-list) to add a transport certificate and private key to Azure Key Vault, and project them into Kubernetes cluster.
+1. Follow the steps in [configure mutual trust](howto-configure-opcua-certificates-infrastructure.md#configure-the-trusted-certificates-list) to add a transport certificate and private key to Azure Key Vault, and project them into Kubernetes cluster.
 2. In the Azure IoT Operations (preview) portal, select **Use transport authentication certificate** for the **Transport authentication** field and enter the certificate thumbprint.
 
 # [Azure CLI](#tab/cli)
 
-1. Follow the steps in [configure mutual trust](howto-configure-opcua-certificates-infrastructure.md#how-to-handle-the-opc-ua-trusted-certificates-list) to add a transport certificate and private key to Azure Key Vault, and project them into Kubernetes cluster.
+1. Follow the steps in [configure mutual trust](howto-configure-opcua-certificates-infrastructure.md#configure-the-trusted-certificates-list) to add a transport certificate and private key to Azure Key Vault, and project them into Kubernetes cluster.
 
 1. Use a command like the following example to create your asset endpoint:
 

articles/iot-operations/manage-devices-assets/overview-akri.md

@@ -101,6 +101,11 @@ Azure IoT Akri Preview supports the following features:
 
 ## Related content
 
+To learn more about Azure IoT Akri, see:
+
+- [Azure IoT Akri architecture](concept-akri-architecture.md)
+- [Discover OPC UA data sources using Azure IoT Akri](howto-autodetect-opcua-assets-using-akri.md)
+
 To learn more about the open-source CNCF Akri, see the following resources:
 
 - [Documentation](https://docs.akri.sh/)

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

@@ -53,7 +53,7 @@ The following tasks are useful for operations teams in sectors such as industry,
 - Create assets remotely
 - To access asset data, subscribe to OPC UA tags and events
 
-The Azure IoT Operations (preview) portal lets operations teams perform these tasks in a simplified web interface. The portal uses the other services described previously, to complete these tasks.
+The Azure IoT Operations (preview) portal lets operations teams perform these tasks in a simplified web interface. The portal uses the other services described previously, to complete these tasks. You can also use the Azure IoT Operations CLI to manage assets by using the `az iot ops asset` command.
 
 The Azure IoT Operations (preview) portal uses the OPC UA Broker service to exchange data with local OPC UA servers. OPC UA servers are software applications that communicate with assets. The OPC UA broker exposes:
 

articles/iot-operations/toc.yml

@@ -45,28 +45,28 @@ items:
       items:
       - name: Overview
         href: manage-devices-assets/overview-manage-assets.md
-      - name: Concepts
+      - name: Manage your assets
+        href: manage-devices-assets/howto-manage-assets-remotely.md
+      - name: Automatic asset discovery
         items:
         - name: Akri overview
           href: manage-devices-assets/overview-akri.md
         - name: Akri architecture
           href: manage-devices-assets/concept-akri-architecture.md
+        - name: Discover OPC UA data sources with Akri
+          href: manage-devices-assets/howto-autodetect-opcua-assets-using-akri.md
+      - name: Connect to your assets
+        items:
         - name: OPC UA broker overview
           href: manage-devices-assets/overview-opcua-broker.md
-        - name: OPC UA certificates infrastructure overview
+        - name: OPC UA application authentication overview
           href: manage-devices-assets/overview-opcua-broker-certificates-management.md
-      - name: How to
-        items:
-        - name: Manage assets remotely
-          href: manage-devices-assets/howto-manage-assets-remotely.md
-        - name: Discover OPC UA data sources
-          href: manage-devices-assets/howto-autodetect-opcua-assets-using-akri.md
-        - name: Configure OPC UA certificates infrastructure
+        - name: Configure OPC UA application authentication
           href: manage-devices-assets/howto-configure-opcua-certificates-infrastructure.md
+        - name: Configure OPC UA user authentication
+          href: manage-devices-assets/howto-configure-opcua-authentication-options.md
         - name: Configure an OPC PLC simulator
           href: manage-devices-assets/howto-configure-opc-plc-simulator.md
-        - name: Configure OPC UA authentication options
-          href: manage-devices-assets/howto-configure-opcua-authentication-options.md
     - name: Manage MQTT connectivity
       items:
       - name: Overview