Incorporated Shipra's comments

Author: pabel-rh

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

@@ -9,16 +9,16 @@ Threshold rule evaluation is order-dependent. You must follow logical ordering t
 
 Rules must be sequenced logically. Order rules from the most strict (smallest range) to the least strict (largest range) or ensure all ranges are mutually exclusive.
 
-=== Problematic Rule Order Example
+=== Problematic rule order example
 
 If rules are ordered incorrectly, a less restrictive rule can prevent stricter rules from being evaluated:
 
 . `warning: <50`: Any value less than 50 triggers the warning rule and stops evaluation.
-. `success: <10`: This rule is not evaluated because all values less than 10 already matched the preceding warning rule.
+. `success: <10`: This rule is not evaluated because all values less than 10 have already matched the preceding warning rule.
 
-=== Correct Ordering Example
+=== Correct ordering example
 
-Order the rules from the most restrictive value range to the least restrictive to ensure logical flow.
+Order the rules from the most restrictive value range to the least restrictive to ensure a logical flow.
 
 [source,yaml]
 ----

modules/observe/scorecards/proc-configuring-github-scorecards-in-rhdh-instance.adoc

@@ -112,6 +112,7 @@ scorecard:
             - key: error
               expression: '>50'
 ----
++
 where:
 
 `scorecard:plugins:github:open_prs:thresholds`:: Lists the default threshold values for the GitHub open PRs metric.

modules/observe/scorecards/proc-configuring-jira-scorecards-in-rhdh-instance.adoc

@@ -87,6 +87,7 @@ jira:
   proxyPath: /jira/api
   product: cloud # Change to 'datacenter' if using Jira Datacenter
 ----
++
 where:
 
 `target`:: The base URL of your Jira instance, configured under ${JIRA_BASE_URL} in your {product-very-short} secrets.
@@ -116,6 +117,7 @@ spec:
   system: examples
   providesApis: [example-grpc-api]
 ----
++
 where:
 
 `jira/project-key`:: Required: Enter the Jira project key.
@@ -152,12 +154,12 @@ 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} `{my-app-config-file}`:
+. (Optional) Define global or custom mandatory filters that entities can override by adding the following code to your {product-very-short} `{my-app-config-file}` file:
 +
 [source,yaml]
 ----
@@ -169,6 +171,7 @@ scorecard:
           mandatoryFilter: Type = Task AND Resolution = Unresolved
           customFilter: priority in ("Critical", "Blocker")
 ----
++
 where:
 
 `mandatoryFilter`:: Optional: Replaces the default filter (`type = Bug and resolution = Unresolved`).

modules/observe/scorecards/proc-installing-scorecard-plugin-in-rhdh-instance.adoc

@@ -11,7 +11,7 @@ You must manually install and enable the plugin in your {product} instance.
 
 .Procedure
 
-* Add the following configuration in your `{product} dynamic-plugin-config.yaml` file:
+* Add the following configuration in your {product-very-short} `dynamic-plugin-config.yaml` file:
 +
 [source,yaml]
 ----