Updates to metadata and headings per Linter

Author: timlt

articles/iot-operations/monitor/howto-add-cluster.md

@@ -1,11 +1,10 @@
 ---
 title: Add a cluster
-titleSuffix: Azure IoT Operations
 description: How to add an Arc-enabled cluster to existing observability infrastructure in Azure IoT Operations.
 author: timlt
 ms.author: timlt
 ms.topic: how-to
-ms.date: 02/04/2024
+ms.date: 02/27/2024
 
 # CustomerIntent: As an IT admin or operator, I want to add more Arc-enabled clusters
 # to my existing observability infrastructure. 
@@ -19,7 +18,7 @@ You can share observability resources across multiple Arc-enabled clusters that
 
 ## Prerequisites
 
-- Azure IoT Operations Preview installed. For more information, see [Get started: configure observability](howto-configure-observability.md).
+- Azure IoT Operations installed. For more information, see [Get started: configure observability](howto-configure-observability.md).
 
 ## Add an Arc-enabled cluster
 To create this setup, run the following command. Specify the two resource IDs for the observability components that were output when you ran the steps in [Install observability components](howto-configure-observability.md#install-observability-components). 

articles/iot-operations/monitor/howto-clean-up-observability-resources.md

@@ -1,7 +1,6 @@
 ---
 title: Clean up observability resources
-titleSuffix: Azure IoT Operations
-description: How to clean up observability resources in Azure IoT Operations.
+description: How to clean up shared and data collection observability resources from an existing installation in Azure IoT Operations.
 author: timlt
 ms.author: timlt
 ms.topic: how-to
@@ -14,36 +13,36 @@ ms.date: 02/04/2024
 # Clean up observability resources
 This article shows how to clean up the observability resources in your cluster without removing the cluster itself. 
 
-## Delete shared resources
+## Delete resources
 
-To uninstall the observability resources, navigate to the resource group where you installed the shared resources and delete the following resources:
+To uninstall the observability resources, complete the following steps.
 
-- Azure Monitor Workspace
-- Azure Managed Grafana
-- Log Analytics Workspace
-- Container Insights Solution
+1. Navigate to the resource group where you installed the shared resources, and delete the following resources:
 
-For a resource group with a single cluster connected, the following screenshot shows what the list of resources looks like:
-
-:::image type="content" source="media/howto-clean-up-observability-resources/shared-resource-delete.png" alt-text="Screenshot that lists shared resources."  lightbox="media/howto-clean-up-observability-resources/shared-resource-delete-expanded.png":::
+    - Azure Monitor Workspace
+    - Azure Managed Grafana
+    - Log Analytics Workspace
+    - Container Insights Solution
 
-## Delete data collection resources
+For a resource group with a single cluster connected, the following screenshot shows what the list of resources looks like:
 
-Next, navigate to the resource group where your cluster is located (if different from the resource group for the previous resources). 
+:::image type="content" source="media/howto-clean-up-observability-resources/shared-resource-delete.png" alt-text="Screenshot that lists a set of shared resources."  lightbox="media/howto-clean-up-observability-resources/shared-resource-delete-expanded.png":::
 
-Delete the following five resources to complete the cleanup without removing the cluster itself:
-- The data collection endpoint
-- The two data collection rules (one ends with "logsDataCollectionRule" and the other ends with "metricsDataCollectionRule")
-- The two recording rule groups (one ends with "KubernetesRecordingRuleGroup" and the other ends with "NodeRecordingRuleGroup")
+1. Navigate to the resource group where your cluster is located (if different from the resource group for the previous resources). Delete the following resources: 
 
-> [!NOTE]  
-> You might need to run the delete more than once for all resources to be successfully deleted. 
+    - The data collection endpoint
+    - The two data collection rules (one ends with "logsDataCollectionRule" and the other ends with "metricsDataCollectionRule")
+    - The two recording rule groups (one ends with "KubernetesRecordingRuleGroup" and the other ends with "NodeRecordingRuleGroup")
 
-For a typical cluster resource group, the following screenshot shows what the list of resources looks like. The resources to delete are selected. 
+    > [!NOTE]  
+    > You might need to run the delete more than once for all resources to be successfully deleted. 
 
-:::image type="content" source="media/howto-clean-up-observability-resources/cluster-resource-delete.png" alt-text="Screenshot that lists shared resources to delete."  lightbox="media/howto-clean-up-observability-resources/cluster-resource-delete-expanded.png":::
+    For a typical cluster resource group, the following screenshot shows what the list of resources looks like. The resources to delete are selected. 
+    
+    :::image type="content" source="media/howto-clean-up-observability-resources/cluster-resource-delete.png" alt-text="Screenshot that lists several resources to delete."  lightbox="media/howto-clean-up-observability-resources/cluster-resource-delete-expanded.png":::
 
 ## Delete the configuration from your cluster
+
 Finally, you can remove the configuration that was installed on your cluster. To do that, run the following command:
 
 ```bash

articles/iot-operations/monitor/howto-configure-diagnostics.md

@@ -1,20 +1,19 @@
 ---
 title: Configure MQ diagnostics service
-titleSuffix: Azure IoT MQ
-description: How to configure Azure IoT MQ diagnostics service.
+description: How to configure the Azure IoT MQ diagnostics service to create a Prometheus endpoint, and monitor the health of the system.
 author: timlt
 ms.author: timlt
 ms.subservice: mq
-ms.topic: how-to
+ms.topic: concept-article
 ms.custom:
   - ignite-2023
-ms.date: 11/14/2023
+ms.date: 02/27/2024
 
 #CustomerIntent: As an operator, I want to understand how to use observability and diagnostics 
 #to monitor the health of the MQ service.
 ---
 
-# Configure Azure IoT MQ diagnostic service settings
+# Configure Azure IoT MQ Preview diagnostic service settings
 
 Azure IoT MQ includes a diagnostics service that periodically self tests Azure IoT MQ components and emits metrics. Operators can use these metrics to monitor the health of the system. The diagnostics service provides a Prometheus endpoint for metrics from all IoT MQ components including Broker self-test metrics.
 
@@ -37,7 +36,9 @@ The diagnostics service processes and collates diagnostic signals from various A
 | openTelemetryTracesCollectorAddr | false | String | `null` | Endpoint URL of the OpenTelemetry collector |
 | staleDataTimeoutSeconds | false | Int32 | `600` | Data timeouts in seconds |
 
-Here's an example of a Diagnostics service resource with basic configuration:
+## Example of a diagnostics service resource
+
+Here's an example of a diagnostics service resource with basic configuration:
 
 ```yaml
 apiVersion: mq.iotoperations.azure.com/v1beta1

articles/iot-operations/monitor/howto-configure-observability-manual.md

@@ -1,6 +1,5 @@
 ---
 title: Configure observability manually
-titleSuffix: Azure IoT Operations
 description: How to configure observability features manually in Azure IoT Operations so that you can monitor your solution.
 author: timlt
 ms.author: timlt

articles/iot-operations/monitor/howto-configure-observability.md

@@ -1,6 +1,5 @@
 ---
 title: Get started with observability
-titleSuffix: Azure IoT Operations
 description: How to get started with configuring observability features in Azure IoT Operations so that you can monitor your solution.
 author: timlt
 ms.author: timlt
@@ -17,11 +16,11 @@ ms.date: 11/7/2023
 
 [!INCLUDE [public-preview-note](../includes/public-preview-note.md)]
 
-Observability provides visibility into every layer of your Azure IoT Operations Preview configuration. It gives you insight into the actual behavior of issues, which increases the effectiveness of site reliability engineering. Azure IoT Operations offers observability through custom curated Grafana dashboards that are hosted in Azure. These dashboards are powered by Azure Monitor managed service for Prometheus and by Container Insights. This article shows you how to configure the services you need for observability. 
+Observability provides visibility into every layer of your Azure IoT Operations configuration. It gives you insight into the actual behavior of issues, which increases the effectiveness of site reliability engineering. Azure IoT Operations offers observability through custom curated Grafana dashboards that are hosted in Azure. These dashboards are powered by Azure Monitor managed service for Prometheus and by Container Insights. This article shows you how to configure the services you need for observability. 
 
 ## Prerequisites
 
-- Azure IoT Operations Preview installed. For more information, see [Quickstart: Deploy Azure IoT Operations – to an Arc-enabled Kubernetes cluster](../get-started/quickstart-deploy.md).
+- Azure IoT Operations installed. For more information, see [Quickstart: Deploy Azure IoT Operations – to an Arc-enabled Kubernetes cluster](../get-started/quickstart-deploy.md).
 
 ## Configure your subscription