RHIDP-12601: updated YAML example based on dev comments

Author: rh-tokeefe

modules/observability_evaluate-project-health-using-scorecards/proc-configure-custom-severity-levels-and-colors-for-scorecard.adoc

@@ -6,6 +6,11 @@
 [role="_abstract"]
 Customizing severity thresholds and color mappings in your Scorecard configuration allows you to visualize platform metrics using your organization's custom operational terminology.
 
+[NOTE]
+====
+You must explicitly configure a corresponding icon component layout key for each custom severity color level you declare. Custom severity metrics will not render properly in the dashboard overview if the icon parameter is missing or invalid.
+====
+
 .Prerequisites
 * You have administrative access to the {product} configuration files.
 * An existing default Scorecard plugin configuration is deployed.
@@ -15,7 +20,7 @@ Customizing severity thresholds and color mappings in your Scorecard configurati
 
 2. Navigate to the `scorecard` backend plugin configuration section.
 
-3. Add your custom severity keys and user-defined hex color values under the threshold color mapping block.
+3. Define your custom severity threshold keys by adding hex color parameters to the `colors` mapping object and valid UI icon names to the `icons` mapping object.
 +
 --
 [source,yaml]
@@ -28,12 +33,18 @@ scorecard:
       error: '#C9190B'
       critical: '#A30000'
       info: '#0066CC'
+    icons:
+      success: check
+      warning: warning
+      error: error
+      critical: dangerous
+      info: info
 ----
 --
 4. Save the changes to the configuration file.
 
-5. Restart your {product} instance to apply the new thresholds.
+5. Restart your {product} instance to apply the new threshold rules.
 
 .Verification
 
-* Open the {product} UI, navigate to the Scorecard component, and verify that the custom severity levels display with their specified colors.
+* Open the {product} UI, navigate to the Scorecard component, and verify that the custom severity levels display with the colors and icons you specified.