Dominika's comments

Author: pabel-rh

modules/observe/scorecards/con-best-practices-for-threshold-rules.adoc

@@ -22,12 +22,12 @@ Order the rules from the most restrictive value range to the least restrictive t
 +
 [source,yaml]
 ----
-# Correct Example: Order from most restrictive (Error) to least restrictive (Success)
+# Correct Example: Order from most restrictive (Success) to least restrictive (Error)
 rules:
   - key: success
-    expression: '>50'     # All remaining values above 50
+    expression: '<10'     # Only values below 15
   - key: warning
     expression: '10-50'   # Only values between 10 and 50
   - key: error
-    expression: '<10'     # Only values below 10
+    expression: '>50'     # All remaining values above 50
 ----

modules/observe/scorecards/con-set-global-standards-for-metric-thresholds.adoc

@@ -5,7 +5,7 @@
 
 To override the default thresholds set by a metric provider, you must update your `{product-very-short} app-config.yaml` file under the configuration path of the specific metric.
 
-The custom configuration completely replaces the provider's defaults. If you omit a threshold category (such as `success`), that category is not assigned unless it is explicitly overridden later by an entity annotation in the `catalog-info.yaml` file.
+The custom configuration completely replaces the provider's defaults. If you omit a threshold category (such as `success`), that category is not assigned.
 
 The following configuration defines a `success` threshold as 10 or fewer issues, which applies to all components using the `jira.open_issues` metric unless explicitly overridden by an entity annotation.
 +

modules/observe/scorecards/proc-authenticating-and-managing-scorecard-plugins.adoc

@@ -18,7 +18,7 @@ p, role:default/scorecard-viewer, catalog.entity.read, read, allow
 See {authorization-book-link}#ref-rbac-permission-policies_title-authorization[Permission policies reference].
 
 ** To use the RBAC Web UI, complete the following steps:
-... In your {product} menu, go to *Settings > RBAC*.
+... In your {product} menu, go to *Administration > RBAC*.
 ... Select or create the *Role* to which you want to grant access to the Scorecards.
 ... To enable read access for the Scorecard plugin, add a policy with the following details and click *Next*:
 **** *Permission*: `scorecard.metric.read`