Incorporated Dominika's comments and added images

Author: pabel-rh

images/rhdh/scorecard-create-role.png

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

images/rhdh/scorecard-sample.png

@@ -5,4 +5,6 @@
 
 include::{docdir}/artifacts/snip-developer-preview.adoc[]
 
-The Scorecard plugin offers comprehensive, customizable insights into the health, security posture, and compliance of your components, services, and APIs. It centralizes Key Performance Indicators (KPIs) within {product} ({product-very-short}), so you do not have to consult multiple external systems.
+The Scorecard plugin offers comprehensive, customizable insights into the health, security posture, and compliance of your components, services, and APIs. It centralizes Key Performance Indicators (KPIs) within {product} ({product-very-short}), so you do not have to consult multiple external systems.
+
+image::rhdh/scorecard-sample.png[]

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

@@ -23,4 +23,6 @@ See {authorization-book-link}#ref-rbac-permission-policies_title-authorization[P
 ... To enable read access for the Scorecard plugin, add a policy with the following details and click *Next*:
 **** *Permission*: `scorecard.metric.read`
 **** *Action*: `read`
-**** *Effect*: `allow`
+**** *Effect*: `allow`
+
+image::rhdh/scorecard-create-role.png[]

modules/observe/scorecards/con-understand-scorecard-plugins.adoc

@@ -102,7 +102,7 @@ scorecard:
               expression: '>50'
 ----
 +
-`scorecard:plugins:github:open_prs:threshold`:: Lists the default threshold values for the GitHub metrics.
+`scorecard:plugins:github:open_prs:thresholds`:: Lists the default threshold values for the GitHub open PRs metric.
 
 [NOTE]
 ====

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

@@ -128,6 +128,10 @@ scorecard:
             - key: error
               expression: '>50'
 ----
+where
+
+`scorecard:plugins:jira:open_issues:thresholds`:: Lists the default threshold values for the Jira open Issues metric.
+
 . (Optional) Define global or custom mandatory filters.
 .. You can apply global mandatory filters or define custom filters that entities can override. Add the following to your `{product-very-short} app-config.yaml`:
 +