fix build validation suggestions, update ms.date metadata and formatting

Author: amsliu

support/azure/azure-monitor/activity-logs/config-export/understanding-and-transitioning-from-legacy-to-diagnostic-settings.md

@@ -1,7 +1,7 @@
 ---
 title: Understanding and Transitioning from Legacy to Diagnostic Settings for Activity Logs
 description: Provides step-by-step instructions to transition from legacy to diagnostic settings.
-ms.date: 07/16/2025
+ms.date: 07/22/2025
 ms.reviewer: v-liuamson; v-gsitser
 ms.service: azure-monitor
 ms.custom: I can’t configure export of Activity Logs
@@ -11,9 +11,17 @@ ms.custom: I can’t configure export of Activity Logs
 
 When Azure announced the transition from legacy solutions to diagnostic settings for forwarding activity logs, users received notifications about necessary updates. This article provides guidance on how to manage this transition effectively.
 
-### Introduction
+## Introduction
 Azure is retiring the legacy solution for forwarding activity logs and replacing it with diagnostic settings. This change is automatic, but users with automation relying on the legacy API need to update their configurations. This guide will help you verify your current setup and make necessary adjustments.
 
+## Common Issues and Solutions
+
+- **Issue:** Unable to find existing log profiles.
+  - **Solution:** Ensure you are using the correct commands and have the necessary permissions to access log profiles.
+
+- **Issue:** Automation scripts fail after the transition.
+  - **Solution:** Double-check that all scripts are updated to use the new diagnostic settings API.
+
 ### Step-by-Step Instructions to Transition to Diagnostic Settings
 
 1. **Verify Existing Log Profiles**
@@ -22,24 +30,16 @@ Azure is retiring the legacy solution for forwarding activity logs and replacing
 
 2. **Update Automation Scripts**
    - If you have automation scripts using the legacy API, update them to use the diagnostic settings API by September 30, 2026.
-   - Refer to the [Azure Monitor documentation](https://learn.microsoft.com/azure/azure-monitor/platform/activity-log?tabs=powershell#managing-legacy-log-profiles---retiring) for detailed instructions.
+   - Refer to the [Azure Monitor documentation](/azure/azure-monitor/platform/activity-log?tabs=powershell#managing-legacy-log-profiles---retiring) for detailed instructions.
 
 3. **Manual Transition to Diagnostic Settings**
    - For users with legacy log profiles, manually transition to diagnostic settings by following the steps outlined in the Azure documentation.
    - Ensure all configurations are updated before the retirement date to avoid disruptions.
 
-### Common Issues and Solutions
-
-- **Issue:** Unable to find existing log profiles.
-  - **Solution:** Ensure you are using the correct commands and have the necessary permissions to access log profiles.
-
-- **Issue:** Automation scripts fail after the transition.
-  - **Solution:** Double-check that all scripts are updated to use the new diagnostic settings API.
-
-### Reference
+## Reference
 
-- [Azure Monitor Documentation](https://learn.microsoft.com/azure/azure-monitor/platform/activity-log?tabs=powershell#managing-legacy-log-profiles---retiring)
-- [Get-AzLogProfile Command](https://learn.microsoft.com/powershell/module/az.monitor/get-azlogprofile?view=azps-14.0.0)
-- [Azure CLI Log Profiles](https://learn.microsoft.com/cli/azure/monitor/log-profiles?view=azure-cli-latest#az-monitor-log-profiles-list)
+- [Azure Monitor Documentation](/azure/azure-monitor/platform/activity-log?tabs=powershell#managing-legacy-log-profiles---retiring)
+- [Get-AzLogProfile Command](/powershell/module/az.monitor/get-azlogprofile?view=azps-14.0.0)
+- [Azure CLI Log Profiles](/cli/azure/monitor/log-profiles?view=azure-cli-latest#az-monitor-log-profiles-list)
 
 If the issue persists after following the solution steps, please open a support case for further assistance.