From 3c2dedf25022c48ea6ee91104a11b0bc8fd845a4 Mon Sep 17 00:00:00 2001
From: Joseph Barnes <jabarnes@me.com>
Date: Sat, 30 Sep 2023 12:00:21 -0500
Subject: [PATCH] updated contrib guide for new settings

---
 docs/content/contributing/_index.md               | 15 +++++++++++----
 .../Compute/virtualMachineScaleSets/_index.md     |  2 +-
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/docs/content/contributing/_index.md b/docs/content/contributing/_index.md
index 8f083e0ff..eaa1bf7fe 100644
--- a/docs/content/contributing/_index.md
+++ b/docs/content/contributing/_index.md
@@ -64,6 +64,10 @@ Here is an example of an alert definition for an Azure Virtual Machine (Microsof
 - name: Available Memory Bytes (MBytes)
   description: Metric Alert for Virtual Machine Available Memory Bytes (MBytes)
   type: Metric
+  verified: true
+  visible: true
+  tags:
+  - alz
   properties:
     metricName: Available Memory Bytes
     metricNamespace: Microsoft.Compute/virtualMachines
@@ -74,10 +78,6 @@ Here is an example of an alert definition for an Azure Virtual Machine (Microsof
     operator: LessThan
     threshold: 1000
     criterionType: StaticThresholdCriterion
-    verified: true
-    visible: true
-    tags:
-    - alz
   references:
   - name: Supported Metrics for Microsoft.Compute/virtualMachines
     urls: https://learn.microsoft.com/azure/azure-monitor/reference/supported-metrics/microsoft-compute-virtualmachines-metrics
@@ -86,6 +86,13 @@ Here is an example of an alert definition for an Azure Virtual Machine (Microsof
     template: Deploy-VM-AvailableMemory-Alert.json
 ```
 
+{{< hint type=note >}}
+Please note the following settings in the alert definition:
+- *verified:* Alert has verified by the PG.
+- *visible:* Alert is visible on the website.
+- *tags:* Tags for filtering alerts based on scenario/pattern (e.g. alz)
+{{< /hint >}}
+
 ## Context/Background
 
 Before jumping into the pre-requisites and specific section contribution guidance, please familiarize yourself with this context/background on how this library is built to help you contribute going forward.
diff --git a/services/Compute/virtualMachineScaleSets/_index.md b/services/Compute/virtualMachineScaleSets/_index.md
index a4078f016..54ae597db 100644
--- a/services/Compute/virtualMachineScaleSets/_index.md
+++ b/services/Compute/virtualMachineScaleSets/_index.md
@@ -1,5 +1,5 @@
 ---
-title: virtualMachineScaleSets
+title: Virtual Machine Scale Sets
 geekdocCollapseSection: true
 ---