Merge pull request #542 from jhkrug/cncf-ref1-lang-active

CNCF suggested review for language/active. Reference, part1

Author: jvanz

docs/reference/artifacts.md

@@ -27,7 +27,7 @@ Kubewarden publishes the `kwctl` CLI tool at
 
 ### OCI artifacts
 
-For OCI artifacts, the project publishes everything in ghcr.io at
+For Open Container Initiative (OCI) artifacts, the project publishes everything in ghcr.io at
 [github.com/orgs/kubewarden/packages](https://github.com/orgs/kubewarden/packages).
 This includes:
 
@@ -44,4 +44,4 @@ This includes:
 
 Kubewarden publishes Helm charts in the Helm chart HTTPS repository at
 [charts.kubewarden.io](https://charts.kubewarden.io)
-(they're without SLSA, or signatures, but this Helm repository provides searching).
+They're without SLSA, or signatures, but this Helm repository provides searching.

docs/reference/dependency-matrix.md

@@ -17,13 +17,13 @@ This page lists the dependencies of Kubewarden, with their relevant
 version constraints. Versions outside of the provided ranges may work but are
 not tested.
 
-## Opentelemetry, metrics and tracing dependencies
+## OpenTelemetry, metrics and tracing dependencies
 
-At the time of writing, the [Opentelemetry](https://opentelemetry.io) stack
-keeps improving. Still, is not yet stable, and unannounced
-backwards-incompatible changes still happen. Kubewarden devs do their best to
-track Opentelemetry stack changes and adjust to them. Kubewarden is tested against a known working
-range of Opentelemetry, metrics and tracing stack.
+At the time of writing, the [OpenTelemetry](https://opentelemetry.io) stack
+keeps improving. However, it's not yet stable, and unannounced
+backwards-incompatible changes still happen. The Kubewarden developers endeavor
+to track OpenTelemetry stack changes and adjust to them. The project tests
+against a known working range of OpenTelemetry, metrics and tracing stack.
 
 ## Optional dependencies
 
@@ -42,5 +42,5 @@ Needed for specific features.
 
 ## Rancher
 
-For downstream consumers such as Rancher, Kubewarden is tested against the
-monitoring and tracing Helm charts provided in the Rancher charts repository.
+Kubewarden tests against the monitoring and tracing Helm charts provided in the
+Rancher charts repository.

docs/reference/metrics-reference.md

@@ -31,8 +31,8 @@ key-value attributes are added to the metric to provide additional information.
 :::
 
 Name | Type | |
---- | --- | ---
-`kubewarden_policy_evaluations_total` | Counter | [Baggage](#kubewarden_policy_evaluations_total)
+--- | --- | --- |
+`kubewarden_policy_evaluations_total` | Counter | [Baggage](#kubewarden_policy_evaluations_total) |
 
 #### `kubewarden_policy_evaluations_total`
 
@@ -45,6 +45,6 @@ Label | Description |
 `resource_kind` | Kind of the evaluated resource |
 `resource_namespace` | Namespace of the evaluated resource. Not present if the resource is cluster scoped. |
 `resource_request_operation` | Operation type: `CREATE`, `UPDATE`, `DELETE`, `PATCH`, `WATCH`... |
-`accepted` | Whether the request was accepted or not |
-`mutated` | Whether the request was mutated or not |
-`error_code` | Error code returned by the policy in case of rejection, if any. Not present if the policy didn't provide one. |
+`accepted` | Was the request accepted? |
+`mutated` | Was the request mutated? |
+`error_code` | Error code returned by the policy if rejected, if any. Not present if the policy didn't provide one. |