From dcfdce56a167beba9840251313804f392ef299c1 Mon Sep 17 00:00:00 2001
From: Clayton Cornell <131809008+clayton-cornell@users.noreply.github.com>
Date: Mon, 27 Nov 2023 11:46:56 -0800
Subject: [PATCH] Update shared content topics (#5845)

* Update layout and syntax in shared topics

* Updates to language passive voice use etc

* General updates to words syntax and voice

* Fix sorting in table

* Fix table spacing

* Correct capitalization of boolean

* Apply suggestions from code review

Co-authored-by: Robert Fratto <robertfratto@gmail.com>

* Update docs/sources/shared/flow/reference/components/otelcol-debug-metrics-block.md

---------

Co-authored-by: Robert Fratto <robertfratto@gmail.com>
---
 .../components/authorization-block.md         | 13 +++---
 .../reference/components/azuread-block.md     |  6 +--
 .../reference/components/basic-auth-block.md  | 13 +++---
 .../components/exporter-component-exports.md  |  9 ++--
 .../components/extract-field-block.md         | 33 ++++++-------
 .../components/field-filter-block.md          | 18 ++++----
 .../components/http-client-config-block.md    | 18 ++++----
 .../components/local-file-arguments-text.md   | 25 ++++------
 .../reference/components/loki-server-grpc.md  | 25 +++++-----
 .../reference/components/loki-server-http.md  | 19 ++++----
 .../components/managed_identity-block.md      | 10 ++--
 .../components/match-properties-block.md      | 18 ++++----
 .../flow/reference/components/oauth2-block.md | 23 +++++-----
 .../components/otelcol-compression-field.md   |  7 ++-
 .../components/otelcol-debug-metrics-block.md | 12 ++---
 .../otelcol-filter-attribute-block.md         | 10 ++--
 .../otelcol-filter-library-block.md           | 12 ++---
 .../otelcol-filter-log-severity-block.md      | 13 +++---
 .../components/otelcol-filter-regexp-block.md |  8 ++--
 .../otelcol-filter-resource-block.md          | 12 ++---
 .../components/otelcol-grpc-authority.md      |  7 ++-
 .../components/otelcol-grpc-balancer-name.md  |  8 ++--
 .../components/otelcol-queue-block.md         | 29 +++++-------
 .../components/otelcol-retry-block.md         | 34 ++++++--------
 .../components/otelcol-tls-config-block.md    | 41 ++++++++---------
 .../reference/components/output-block-logs.md | 15 +++---
 .../components/output-block-metrics.md        |  9 ++--
 .../components/output-block-traces.md         | 15 +++---
 .../flow/reference/components/output-block.md | 19 ++++----
 .../components/prom-operator-scrape.md        |  8 ++--
 .../reference/components/rule-block-logs.md   | 46 +++++++++----------
 .../flow/reference/components/rule-block.md   | 42 ++++++++---------
 .../flow/reference/components/sigv4-block.md  | 14 +++---
 .../reference/components/tls-config-block.md  | 25 +++++-----
 34 files changed, 286 insertions(+), 330 deletions(-)

diff --git a/docs/sources/shared/flow/reference/components/authorization-block.md b/docs/sources/shared/flow/reference/components/authorization-block.md
index 190cd11f8bb9..11a74326f997 100644
--- a/docs/sources/shared/flow/reference/components/authorization-block.md
+++ b/docs/sources/shared/flow/reference/components/authorization-block.md
@@ -10,11 +10,10 @@ description: Shared content, authorization block
 headless: true
 ---
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`type` | `string` | Authorization type, for example, "Bearer". | | no
-`credentials` | `secret` | Secret value. | | no
-`credentials_file` | `string` | File containing the secret value. | | no
+Name               | Type     | Description                                | Default | Required
+-------------------|----------|--------------------------------------------|---------|---------
+`credentials_file` | `string` | File containing the secret value.          |         | no
+`credentials`      | `secret` | Secret value.                              |         | no
+`type`             | `string` | Authorization type, for example, "Bearer". |         | no
 
-`credential` and `credentials_file` are mutually exclusive and only one can be
-provided inside of an `authorization` block.
+`credential` and `credentials_file` are mutually exclusive, and only one can be provided inside an `authorization` block.
diff --git a/docs/sources/shared/flow/reference/components/azuread-block.md b/docs/sources/shared/flow/reference/components/azuread-block.md
index ebdf436d02fe..07d974385134 100644
--- a/docs/sources/shared/flow/reference/components/azuread-block.md
+++ b/docs/sources/shared/flow/reference/components/azuread-block.md
@@ -10,11 +10,11 @@ description: Shared content, azuread block
 headless: true
 ---
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
+Name    | Type     | Description      | Default         | Required
+--------|----------|------------------|-----------------|---------
 `cloud` | `string` | The Azure Cloud. | `"AzurePublic"` | no
 
 The supported values for `cloud` are:
 * `"AzurePublic"`
 * `"AzureChina"`
-* `"AzureGovernment"`
\ No newline at end of file
+* `"AzureGovernment"`
diff --git a/docs/sources/shared/flow/reference/components/basic-auth-block.md b/docs/sources/shared/flow/reference/components/basic-auth-block.md
index 06c81f660e3c..62f7e0a25d61 100644
--- a/docs/sources/shared/flow/reference/components/basic-auth-block.md
+++ b/docs/sources/shared/flow/reference/components/basic-auth-block.md
@@ -10,11 +10,10 @@ description: Shared content, basic auth block
 headless: true
 ---
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`username` | `string` | Basic auth username. | | no
-`password` | `secret` | Basic auth password. | | no
-`password_file` | `string` | File containing the basic auth password. | | no
+Name            | Type     | Description                              | Default | Required
+----------------|----------|------------------------------------------|---------|---------
+`password_file` | `string` | File containing the basic auth password. |         | no
+`password`      | `secret` | Basic auth password.                     |         | no
+`username`      | `string` | Basic auth username.                     |         | no
 
-`password` and `password_file` are mutually exclusive and only one can be
-provided inside of a `basic_auth` block.
+`password` and `password_file` are mutually exclusive, and only one can be provided inside a `basic_auth` block.
diff --git a/docs/sources/shared/flow/reference/components/exporter-component-exports.md b/docs/sources/shared/flow/reference/components/exporter-component-exports.md
index beb717a13fae..f1a8ca440cd9 100644
--- a/docs/sources/shared/flow/reference/components/exporter-component-exports.md
+++ b/docs/sources/shared/flow/reference/components/exporter-component-exports.md
@@ -13,15 +13,12 @@ headless: true
 The following fields are exported and can be referenced by other components.
 
 Name      | Type                | Description
---------- | ------------------- | -----------
+----------|---------------------|----------------------------------------------------------
 `targets` | `list(map(string))` | The targets that can be used to collect exporter metrics.
 
-For example, the `targets` can either be passed to a `discovery.relabel`
-component to rewrite the targets' label sets, or to a `prometheus.scrape`
-component that collects the exposed metrics.
+For example, the `targets` can either be passed to a `discovery.relabel` component to rewrite the targets' label sets or to a `prometheus.scrape` component that collects the exposed metrics.
 
-The exported targets will use the configured [in-memory traffic][] address
-specified by the [run command][].
+The exported targets use the configured [in-memory traffic][] address specified by the [run command][].
 
 [in-memory traffic]: {{< relref "../../../../flow/concepts/component_controller.md#in-memory-traffic" >}}
 [run command]: {{< relref "../../../../flow/reference/cli/run.md" >}}
diff --git a/docs/sources/shared/flow/reference/components/extract-field-block.md b/docs/sources/shared/flow/reference/components/extract-field-block.md
index 5036097d155f..207f2bc6053d 100644
--- a/docs/sources/shared/flow/reference/components/extract-field-block.md
+++ b/docs/sources/shared/flow/reference/components/extract-field-block.md
@@ -12,31 +12,28 @@ headless: true
 
 The following attributes are supported:
 
-Name | Type           | Description                                                                                              | Default | Required
----- |----------------|----------------------------------------------------------------------------------------------------------|---------| --------
-`tag_name` | `string` | The name of the resource attribute that will be added to logs, metrics, or spans.      | `""` | no
-`key` | `string` | The annotation (or label) name. This must exactly match an annotation (or label) name.    |  `""` | no
-`key_regex` | `string` | A regular expression used to extract a key that matches the regex.                           | `""` | no
-`regex` | `string` | An optional field used to extract a sub-string from a complex field value.                      | `""` | no
-`from` | `string` | The source of the labels or annotations. Allowed values are `pod` and `namespace`.          | `pod`    | no
-
-When `tag_name` is not specified, a default tag name will be used with the format:
+Name        | Type     | Description                                                                            | Default | Required
+------------|----------|----------------------------------------------------------------------------------------|---------|---------
+`from`      | `string` | The source of the labels or annotations. Allowed values are `pod` and `namespace`.     | `pod`   | no
+`key_regex` | `string` | A regular expression used to extract a key that matches the regular expression.        | `""`    | no
+`key`       | `string` | The annotation or label name. This key must exactly match an annotation or label name. | `""`    | no
+`regex`     | `string` | An optional field used to extract a sub-string from a complex field value.             | `""`    | no
+`tag_name`  | `string` | The name of the resource attribute added to logs, metrics, or spans.                   | `""`    | no
+
+When you don't specify the `tag_name`, a default tag name is used with the format:
 * `k8s.pod.annotations.<annotation key>`
 * `k8s.pod.labels.<label key>`
 
-For example, if `tag_name` is not specified and the key is `git_sha`, then the attribute name will be
-`k8s.pod.annotations.git_sha`.
+For example, if `tag_name` isn't specified and the key is `git_sha`, the attribute name will be `k8s.pod.annotations.git_sha`.
 
-Either the `key` attribute or the `key_regex` attribute should be set, not both.
-When `key_regex` is present, `tag_name` supports back reference to both
-named capturing and positioned capturing.
+You can set either the `key` attribute or the `key_regex` attribute, but not both.
+When `key_regex` is present, `tag_name` supports back reference to both named capturing and positioned capturing.
 
 For example, assume your pod spec contains the following labels:
 * `app.kubernetes.io/component: mysql`
 * `app.kubernetes.io/version: 5.7.21`
 
-If you'd like to add tags for all labels with prefix `app.kubernetes.io/` and trim the prefix, 
-then you can specify the following extraction rules:
+If you'd like to add tags for all labels with the prefix `app.kubernetes.io/` and trim the prefix, then you can specify the following extraction rules:
 
 ```river
 extract {
@@ -48,6 +45,6 @@ extract {
 }
 ```
 
-These rules will add the `component` and `version` tags to the spans or metrics.
+These rules add the `component` and `version` tags to the spans or metrics.
 
-The `from` attribute can be set to either `"pod"` or `"namespace"`.
+You can set the `from` attribute to either `"pod"` or `"namespace"`.
diff --git a/docs/sources/shared/flow/reference/components/field-filter-block.md b/docs/sources/shared/flow/reference/components/field-filter-block.md
index bf9d787f2d97..266af75980a5 100644
--- a/docs/sources/shared/flow/reference/components/field-filter-block.md
+++ b/docs/sources/shared/flow/reference/components/field-filter-block.md
@@ -13,14 +13,14 @@ headless: true
 
 The following attributes are supported:
 
-Name | Type     | Description                                                                       | Default | Required
----- |----------|-----------------------------------------------------------------------------------|---------| --------
-`key` | `string` | The key or name of the field or labels that a filter can use. |         | yes
-`value` | `string` | The value associated with the key that a filter can use.    |         | yes
-`op` | `string` | The filter operation to apply on the given key: value pair.         | `equals` | no
+Name    | Type     | Description                                                   | Default  | Required
+--------|----------|---------------------------------------------------------------|----------|---------
+`key`   | `string` | The key or name of the field or labels that a filter can use. |          | yes
+`value` | `string` | The value associated with the key that a filter can use.      |          | yes
+`op`    | `string` | The filter operation to apply on the given key: value pair.   | `equals` | no
 
-For `op` the following values are allowed:
-* `equals`: The field value must be equal to the provided value.
+For `op`, the following values are allowed:
+* `equals`: The field value must equal the provided value.
 * `not-equals`: The field value must not be equal to the provided value.
-* `exists`: The field value must exist. (Only for `annotation` fields).
-* `does-not-exist`: The field value must not exist. (Only for `annotation` fields).
+* `exists`: The field value must exist. Only applicable to `annotation` fields.
+* `does-not-exist`: The field value must not exist. Only applicable to `annotation` fields.
diff --git a/docs/sources/shared/flow/reference/components/http-client-config-block.md b/docs/sources/shared/flow/reference/components/http-client-config-block.md
index 9519d0d8d67f..04a680c51a21 100644
--- a/docs/sources/shared/flow/reference/components/http-client-config-block.md
+++ b/docs/sources/shared/flow/reference/components/http-client-config-block.md
@@ -10,14 +10,12 @@ description: Shared content, http client config block
 headless: true
 ---
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`bearer_token` | `secret` | Bearer token to authenticate with. | | no
-`bearer_token_file` | `string` | File containing a bearer token to authenticate with. | | no
-`proxy_url` | `string` | HTTP proxy to proxy requests through. | | no
-`follow_redirects` | `bool` | Whether redirects returned by the server should be followed. | `true` | no
-`enable_http2` | `bool` | Whether HTTP2 is supported for requests. | `true` | no
+Name                | Type     | Description                                                  | Default | Required
+--------------------|----------|--------------------------------------------------------------|---------|---------
+`bearer_token_file` | `string` | File containing a bearer token to authenticate with.         |         | no
+`bearer_token`      | `secret` | Bearer token to authenticate with.                           |         | no
+`enable_http2`      | `bool`   | Whether HTTP2 is supported for requests.                     | `true`  | no
+`follow_redirects`  | `bool`   | Whether redirects returned by the server should be followed. | `true`  | no
+`proxy_url`         | `string` | HTTP proxy to send requests through.                         |         | no
 
-`bearer_token`, `bearer_token_file`, `basic_auth`, `authorization`, and
-`oauth2` are mutually exclusive and only one can be provided inside of a
-`http_client_config` block.
+`bearer_token`, `bearer_token_file`, `basic_auth`, `authorization`, and `oauth2` are mutually exclusive, and only one can be provided inside of a `http_client_config` block.
diff --git a/docs/sources/shared/flow/reference/components/local-file-arguments-text.md b/docs/sources/shared/flow/reference/components/local-file-arguments-text.md
index 60bd864aa1d9..4b83c2291c45 100644
--- a/docs/sources/shared/flow/reference/components/local-file-arguments-text.md
+++ b/docs/sources/shared/flow/reference/components/local-file-arguments-text.md
@@ -12,28 +12,21 @@ headless: true
 
 ### File change detectors
 
-File change detectors are used for detecting when the file needs to be re-read
-from disk. `local.file` supports two detectors: `fsnotify` and `poll`.
+File change detectors detect when the file needs to be re-read from disk. `local.file` supports two detectors: `fsnotify` and `poll`.
 
 #### fsnotify
 
-The `fsnotify` detector subscribes to filesystem events which indicate when the
-watched file had been updated. This requires a filesystem which supports events
-at the Operating System level: network-based filesystems like NFS or FUSE won't
-work.
+The `fsnotify` detector subscribes to filesystem events, which indicate when the watched file is updated.
+This detector requires a filesystem that supports events at the operating system level. Network-based filesystems like NFS or FUSE won't work.
 
-When a filesystem event is received, the component will reread the watched
-file. This will happen for any filesystem event to the file, including a change
-of permissions.
+The component re-reads the watched file when a filesystem event is received.
+This re-read happens for any filesystem event related to the file, including a permissions change.
 
-`fsnotify` also polls for changes to the file with the configured
-`poll_frequency` as a fallback.
+`fsnotify` also polls for changes to the file with the configured `poll_frequency` as a fallback.
 
-`fsnotify` will stop receiving filesystem events if the watched file has been
-deleted, renamed, or moved. The subscription will be re-established on the next
-poll once the watched file exists again.
+`fsnotify` stops receiving filesystem events if the watched file has been deleted, renamed, or moved.
+The subscription is re-established on the next poll once the watched file exists again.
 
 #### poll
 
-The `poll` file change detector will cause the watched file to be reread
-every `poll_frequency`, regardless of whether the file changed.
\ No newline at end of file
+The `poll` file change detector causes the watched file to be re-read every `poll_frequency`, regardless of whether the file changed.
diff --git a/docs/sources/shared/flow/reference/components/loki-server-grpc.md b/docs/sources/shared/flow/reference/components/loki-server-grpc.md
index e625eb659a01..ffb0081ec350 100644
--- a/docs/sources/shared/flow/reference/components/loki-server-grpc.md
+++ b/docs/sources/shared/flow/reference/components/loki-server-grpc.md
@@ -12,17 +12,16 @@ headless: true
 
 The `grpc` block configures the gRPC server.
 
-The following arguments can be used to configure the `grpc` block. Any omitted
-fields take their default values.
+You can use the following arguments to configure the `grpc` block. Any omitted fields take their default values.
 
- Name                            | Type       | Description                                                                                                          | Default      | Required 
----------------------------------|------------|----------------------------------------------------------------------------------------------------------------------|--------------|----------
- `listen_address`                | `string`   | Network address on which the server will listen for new connections. Defaults to accepting all incoming connections. | `""`         | no       
- `listen_port`                   | `int`      | Port number on which the server will listen for new connections. Defaults to a random free port being assigned.      | `0`          | no       
- `conn_limit`                    | `int`      | Maximum number of simultaneous http connections. Defaults to no limit.                                               | `0`          | no       
- `max_connection_age`            | `duration` | The duration for the maximum amount of time a connection may exist before it will be closed.                         | `"infinity"` | no       
- `max_connection_age_grace`      | `duration` | An additive period after `max_connection_age` after which the connection will be forcibly closed.                    | `"infinity"` | no       
- `max_connection_idle`           | `duration` | The duration after which an idle connection should be closed.                                                        | `"infinity"` | no       
- `server_max_recv_msg_size`      | `int`      | Limit on the size of a gRPC message this server can receive (bytes).                                                 | `4MB`        | no       
- `server_max_send_msg_size`      | `int`      | Limit on the size of a gRPC message this server can send (bytes).                                                    | `4MB`        | no       
- `server_max_concurrent_streams` | `int`      | Limit on the number of concurrent streams for gRPC calls (0 = unlimited).                                            | `100`        | no       
+Name                            | Type       | Description                                                                                                         | Default      | Required
+--------------------------------|------------|---------------------------------------------------------------------------------------------------------------------|--------------|---------
+`conn_limit`                    | `int`      | Maximum number of simultaneous HTTP connections. Defaults to no limit.                                              | `0`          | no
+`listen_address`                | `string`   | Network address on which the server listens for new connections. It defaults to accepting all incoming connections. | `""`         | no
+`listen_port`                   | `int`      | Port number on which the server listens for new connections. Defaults to a random free port.                        | `0`          | no
+`max_connection_age_grace`      | `duration` | An additive period after `max_connection_age` after which the connection is forcibly closed.                        | `"infinity"` | no
+`max_connection_age`            | `duration` | The duration for the maximum time a connection may exist before it is closed.                                       | `"infinity"` | no
+`max_connection_idle`           | `duration` | The duration after which an idle connection is closed.                                                              | `"infinity"` | no
+`server_max_concurrent_streams` | `int`      | Limit on the number of concurrent streams for gRPC calls (0 = unlimited).                                           | `100`        | no
+`server_max_recv_msg_size`      | `int`      | Limit on the size of a gRPC message this server can receive (bytes).                                                | `4MB`        | no
+`server_max_send_msg_size`      | `int`      | Limit on the size of a gRPC message this server can send (bytes).                                                   | `4MB`        | no
diff --git a/docs/sources/shared/flow/reference/components/loki-server-http.md b/docs/sources/shared/flow/reference/components/loki-server-http.md
index 3a424c57063a..a418dbd892bf 100644
--- a/docs/sources/shared/flow/reference/components/loki-server-http.md
+++ b/docs/sources/shared/flow/reference/components/loki-server-http.md
@@ -12,14 +12,13 @@ headless: true
 
 The `http` block configures the HTTP server.
 
-The following arguments can be used to configure the `http` block. Any omitted
-fields take their default values.
+You can use the following arguments to configure the `http` block. Any omitted fields take their default values.
 
- Name                   | Type       | Description                                                                                                          | Default  | Required
-------------------------|------------|----------------------------------------------------------------------------------------------------------------------|----------|----------
- `listen_address`       | `string`   | Network address on which the server will listen for new connections. Defaults to accepting all incoming connections. | `""`     | no
- `listen_port`          | `int`      | Port number on which the server will listen for new connections.                                                     | `8080`   | no
- `conn_limit`           | `int`      | Maximum number of simultaneous http connections. Defaults to no limit.                                               | `0`      | no
- `server_read_timeout`  | `duration` | Read timeout for HTTP server.                                                                                        | `"30s"`  | no
- `server_write_timeout` | `duration` | Write timeout for HTTP server.                                                                                       | `"30s"`  | no
- `server_idle_timeout`  | `duration` | Idle timeout for HTTP server.                                                                                        | `"120s"` | no
+Name                   | Type       | Description                                                                                                      | Default  | Required
+-----------------------|------------|------------------------------------------------------------------------------------------------------------------|----------|---------
+`conn_limit`           | `int`      | Maximum number of simultaneous HTTP connections. Defaults to no limit.                                           | `0`      | no
+`listen_address`       | `string`   | Network address on which the server listens for new connections. Defaults to accepting all incoming connections. | `""`     | no
+`listen_port`          | `int`      | Port number on which the server listens for new connections.                                                     | `8080`   | no
+`server_idle_timeout`  | `duration` | Idle timeout for HTTP server.                                                                                    | `"120s"` | no
+`server_read_timeout`  | `duration` | Read timeout for HTTP server.                                                                                    | `"30s"`  | no
+`server_write_timeout` | `duration` | Write timeout for HTTP server.                                                                                   | `"30s"`  | no
diff --git a/docs/sources/shared/flow/reference/components/managed_identity-block.md b/docs/sources/shared/flow/reference/components/managed_identity-block.md
index 8422df1ae949..2e51a03050f7 100644
--- a/docs/sources/shared/flow/reference/components/managed_identity-block.md
+++ b/docs/sources/shared/flow/reference/components/managed_identity-block.md
@@ -10,14 +10,14 @@ description: Shared content, managed_identity block
 headless: true
 ---
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`client_id` | `string` | Client ID of the managed identity which is used to authenticate. | | yes
+Name        | Type     | Description                                             | Default | Required
+------------|----------|---------------------------------------------------------|---------|---------
+`client_id` | `string` | Client ID of the managed identity used to authenticate. |         | yes
 
 `client_id` should be a valid [UUID][] in one of the supported formats:
 * `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
-* `urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` 
+* `urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
 * Microsoft encoding: `{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}`
 * Raw hex encoding: `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
 
-[UUID]: https://en.wikipedia.org/wiki/Universally_unique_identifier
\ No newline at end of file
+[UUID]: https://en.wikipedia.org/wiki/Universally_unique_identifier
diff --git a/docs/sources/shared/flow/reference/components/match-properties-block.md b/docs/sources/shared/flow/reference/components/match-properties-block.md
index 16003a6e9122..863f4e406b50 100644
--- a/docs/sources/shared/flow/reference/components/match-properties-block.md
+++ b/docs/sources/shared/flow/reference/components/match-properties-block.md
@@ -12,15 +12,15 @@ headless: true
 
 The following arguments are supported:
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`match_type` | `string` | Controls how items to match against are interpreted. | | yes
-`services` | `list(string)` | A list of items to match the service name against. | `[]` | no
-`span_names` | `list(string)` | A list of items to match the span name against. | `[]` | no
-`log_bodies` | `list(string)` | A list of strings that the LogRecord's body field must match against. | `[]` | no
-`log_severity_texts` | `list(string)` | A list of strings that the LogRecord's severity text field must match against. | `[]` | no
-`metric_names` | `list(string)` | A list of strings to match the metric name against. | `[]` | no
-`span_kinds` | `list(string)` | A list of items to match the span kind against. | `[]` | no
+Name                 | Type           | Description                                                                    | Default | Required
+---------------------|----------------|--------------------------------------------------------------------------------|---------|---------
+`match_type`         | `string`       | Controls how items to match against are interpreted.                           |         | yes
+`log_bodies`         | `list(string)` | A list of strings that the LogRecord's body field must match against.          | `[]`    | no
+`log_severity_texts` | `list(string)` | A list of strings that the LogRecord's severity text field must match against. | `[]`    | no
+`metric_names`       | `list(string)` | A list of strings to match the metric name against.                            | `[]`    | no
+`services`           | `list(string)` | A list of items to match the service name against.                             | `[]`    | no
+`span_kinds`         | `list(string)` | A list of items to match the span kind against.                                | `[]`    | no
+`span_names`         | `list(string)` | A list of items to match the span name against.                                | `[]`    | no
 
 `match_type` is required and must be set to either `"regexp"` or `"strict"`.
 
diff --git a/docs/sources/shared/flow/reference/components/oauth2-block.md b/docs/sources/shared/flow/reference/components/oauth2-block.md
index c08b8ebe65b7..93c2b87ba4df 100644
--- a/docs/sources/shared/flow/reference/components/oauth2-block.md
+++ b/docs/sources/shared/flow/reference/components/oauth2-block.md
@@ -10,17 +10,16 @@ description: Shared content, oauth2 block
 headless: true
 ---
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`client_id` | `string` | OAuth2 client ID. | | no
-`client_secret` | `secret` | OAuth2 client secret. | | no
-`client_secret_file` | `string` | File containing the OAuth2 client secret. | | no
-`scopes` | `list(string)` | List of scopes to authenticate with. | | no
-`token_url` | `string` | URL to fetch the token from. | | no
-`endpoint_params` | `map(string)` | Optional parameters to append to the token URL. | | no
-`proxy_url` | `string` | Optional proxy URL for OAuth2 requests. | | no
+Name                 | Type           | Description                                     | Default | Required
+---------------------|----------------|-------------------------------------------------|---------|---------
+`client_id`          | `string`       | OAuth2 client ID.                               |         | no
+`client_secret_file` | `string`       | File containing the OAuth2 client secret.       |         | no
+`client_secret`      | `secret`       | OAuth2 client secret.                           |         | no
+`endpoint_params`    | `map(string)`  | Optional parameters to append to the token URL. |         | no
+`proxy_url`          | `string`       | Optional proxy URL for OAuth2 requests.         |         | no
+`scopes`             | `list(string)` | List of scopes to authenticate with.            |         | no
+`token_url`          | `string`       | URL to fetch the token from.                    |         | no
 
-`client_secret` and `client_secret_file` are mutually exclusive and only one
-can be provided inside of an `oauth2` block.
+`client_secret` and `client_secret_file` are mutually exclusive, and only one can be provided inside an `oauth2` block.
 
-The `oauth2` block may also contain its own separate `tls_config` sub-block.
+The `oauth2` block may also contain a separate `tls_config` sub-block.
diff --git a/docs/sources/shared/flow/reference/components/otelcol-compression-field.md b/docs/sources/shared/flow/reference/components/otelcol-compression-field.md
index 3a267705b6a7..394cf1077c19 100644
--- a/docs/sources/shared/flow/reference/components/otelcol-compression-field.md
+++ b/docs/sources/shared/flow/reference/components/otelcol-compression-field.md
@@ -10,8 +10,8 @@ description: Shared content, otelcol compression field
 headless: true
 ---
 
-By default, requests are compressed with gzip. The `compression` argument
-controls which compression mechanism to use. Supported strings are:
+By default, requests are compressed with gzip.
+The `compression` argument controls which compression mechanism to use. Supported strings are:
 
 * `"gzip"`
 * `"zlib"`
@@ -19,5 +19,4 @@ controls which compression mechanism to use. Supported strings are:
 * `"snappy"`
 * `"zstd"`
 
-If `compression` is set to `"none"` or an empty string `""`, no compression is
-used.
+If `compression` is set to `"none"` or an empty string `""`, no compression is used.
diff --git a/docs/sources/shared/flow/reference/components/otelcol-debug-metrics-block.md b/docs/sources/shared/flow/reference/components/otelcol-debug-metrics-block.md
index 566abf806cc3..f70facdf3541 100644
--- a/docs/sources/shared/flow/reference/components/otelcol-debug-metrics-block.md
+++ b/docs/sources/shared/flow/reference/components/otelcol-debug-metrics-block.md
@@ -14,12 +14,10 @@ The `debug_metrics` block configures the metrics that this component generates t
 
 The following arguments are supported:
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
+Name                               | Type      | Description                                          | Default | Required
+-----------------------------------|-----------|------------------------------------------------------|---------|---------
 `disable_high_cardinality_metrics` | `boolean` | Whether to disable certain high cardinality metrics. | `false` | no
 
-`disable_high_cardinality_metrics` is the Grafana Agent equivalent to the
-`telemetry.disableHighCardinalityMetrics` feature gate in the OpenTelemetry
-Collector. It removes attributes which could cause high cardinality metrics. For
-example, attributes with IP addresses and port numbers in metrics about HTTP
-and gRPC connections will be removed.
+`disable_high_cardinality_metrics` is the Grafana Agent equivalent to the `telemetry.disableHighCardinalityMetrics` feature gate in the OpenTelemetry Collector.
+It removes attributes that could cause high cardinality metrics.
+For example, attributes with IP addresses and port numbers in metrics about HTTP and gRPC connections are removed.
diff --git a/docs/sources/shared/flow/reference/components/otelcol-filter-attribute-block.md b/docs/sources/shared/flow/reference/components/otelcol-filter-attribute-block.md
index ed05d4fb6d48..b4226ada23f3 100644
--- a/docs/sources/shared/flow/reference/components/otelcol-filter-attribute-block.md
+++ b/docs/sources/shared/flow/reference/components/otelcol-filter-attribute-block.md
@@ -17,10 +17,10 @@ This block specifies an attribute to match against:
 
 The following arguments are supported:
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`key` | `string` | The attribute key. | | yes
-`value` | `any` | The attribute value to match against. | | no
+Name    | Type     | Description                           | Default | Required
+--------|----------|---------------------------------------|---------|---------
+`key`   | `string` | The attribute key.                    |         | yes
+`value` | `any`    | The attribute value to match against. |         | no
 
-If `value` is not set, any value will match.
+If `value` isn't set, any value will match.
 The type of `value` could be a number, a string, or a boolean.
diff --git a/docs/sources/shared/flow/reference/components/otelcol-filter-library-block.md b/docs/sources/shared/flow/reference/components/otelcol-filter-library-block.md
index fafc9fd3d67b..b2d4b5ddacbb 100644
--- a/docs/sources/shared/flow/reference/components/otelcol-filter-library-block.md
+++ b/docs/sources/shared/flow/reference/components/otelcol-filter-library-block.md
@@ -16,10 +16,10 @@ This block specifies properties to match the implementation library against:
 
 The following arguments are supported:
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`name` | `string` | The attribute key. | | yes
-`version` | `string` | The version to match against. | null | no
+Name      | Type     | Description                   | Default | Required
+----------|----------|-------------------------------|---------|---------
+`name`    | `string` | The attribute key.            |         | yes
+`version` | `string` | The version to match against. | null    | no
 
-If `version` is unset, any version will match. If `version` is set to an empty string, it will only match 
-a library version which is also an empty string.
+If `version` is unset, any version matches.
+If `version` is set to an empty string, it only matches a library version, which is also an empty string.
diff --git a/docs/sources/shared/flow/reference/components/otelcol-filter-log-severity-block.md b/docs/sources/shared/flow/reference/components/otelcol-filter-log-severity-block.md
index 15b17450f7f6..35633a4d6bc1 100644
--- a/docs/sources/shared/flow/reference/components/otelcol-filter-log-severity-block.md
+++ b/docs/sources/shared/flow/reference/components/otelcol-filter-log-severity-block.md
@@ -13,14 +13,14 @@ This block defines how to match based on a log record's SeverityNumber field.
 
 The following arguments are supported:
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`min` | `string` | The lowest severity that may be matched. | | yes
-`match_undefined` | `bool` | Whether logs with "undefined" severity match. | | yes
+Name              | Type     | Description                                   | Default | Required
+------------------|----------|-----------------------------------------------|---------|---------
+`match_undefined` | `bool`   | Whether logs with "undefined" severity match. |         | yes
+`min`             | `string` | The lowest severity that may be matched.      |         | yes
 
 If `match_undefined` is true, entries with undefined severity will match.
 
-The severities supported by Otel are listed in the table below. 
+The following table lists the severities supported by OTel.
 The value for `min` should be one of the values in the "Log Severity" column.
 
 Log Severity | Severity number
@@ -50,5 +50,4 @@ FATAL2       | 22
 FATAL3       | 23
 FATAL4       | 24
 
-For example, if the `min` attribute in the `log_severity` block is "INFO", then
-INFO, WARN, ERROR, and FATAL logs will match.
+For example, if the `min` attribute in the `log_severity` block is "INFO", then INFO, WARN, ERROR, and FATAL logs will match.
diff --git a/docs/sources/shared/flow/reference/components/otelcol-filter-regexp-block.md b/docs/sources/shared/flow/reference/components/otelcol-filter-regexp-block.md
index 649b41554877..d265dffc6003 100644
--- a/docs/sources/shared/flow/reference/components/otelcol-filter-regexp-block.md
+++ b/docs/sources/shared/flow/reference/components/otelcol-filter-regexp-block.md
@@ -14,10 +14,10 @@ It configures a Least Recently Used (LRU) cache.
 
 The following arguments are supported:
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`cache_enabled` | `bool` | Determines whether match results are LRU cached. | `false` | no
-`cache_max_num_entries` | `int` | The max number of entries of the LRU cache that stores match results. | `0` | no
+Name                    | Type   | Description                                                           | Default | Required
+------------------------|--------|-----------------------------------------------------------------------|---------|---------
+`cache_enabled`         | `bool` | Determines whether match results are LRU cached.                      | `false` | no
+`cache_max_num_entries` | `int`  | The max number of entries of the LRU cache that stores match results. | `0`     | no
 
 Enabling `cache_enabled` could make subsequent matches faster.
 Cache size is unlimited unless `cache_max_num_entries` is also specified.
diff --git a/docs/sources/shared/flow/reference/components/otelcol-filter-resource-block.md b/docs/sources/shared/flow/reference/components/otelcol-filter-resource-block.md
index 0242f5914e40..446bdac82a05 100644
--- a/docs/sources/shared/flow/reference/components/otelcol-filter-resource-block.md
+++ b/docs/sources/shared/flow/reference/components/otelcol-filter-resource-block.md
@@ -12,14 +12,14 @@ headless: true
 This block specifies items to match the resources against:
 
 * More than one `resource` block can be defined.
-* A match occurs if the input data resources matches at least one `resource` block.
+* A match occurs if the input data resources match at least one `resource` block.
 
 The following arguments are supported:
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`key` | `string` | The resource key. | | yes
-`value` | `any` | The resource value to match against. | | no
+Name    | Type     | Description                          | Default | Required
+--------|----------|--------------------------------------|---------|---------
+`key`   | `string` | The resource key.                    |         | yes
+`value` | `any`    | The resource value to match against. |         | no
 
 If `value` is not set, any value will match.
-The type of `value` could be a number, a string or a boolean.
+The type of `value` could be a number, a string, or a boolean.
diff --git a/docs/sources/shared/flow/reference/components/otelcol-grpc-authority.md b/docs/sources/shared/flow/reference/components/otelcol-grpc-authority.md
index f0616490eef5..15642a0b91b5 100644
--- a/docs/sources/shared/flow/reference/components/otelcol-grpc-authority.md
+++ b/docs/sources/shared/flow/reference/components/otelcol-grpc-authority.md
@@ -10,10 +10,9 @@ headless: true
 ---
 
 The `:authority` header in gRPC specifies the host to which the request is being sent.
-It is similar to the `Host` [header][HTTP host header] in HTTP requests. By default, 
-the value for `:authority` is derived from the endpoint URL used for the gRPC call. 
-Overriding `:authority` could be useful when routing traffic using a proxy like Envoy, which 
-[makes routing decisions][Envoy route matching] based on the value of the `:authority` header.
+It's similar to the `Host` [header][HTTP host header] in HTTP requests.
+By default, the value for `:authority` is derived from the endpoint URL used for the gRPC call.
+Overriding `:authority` could be useful when routing traffic using a proxy like Envoy, which [makes routing decisions][Envoy route matching] based on the value of the `:authority` header.
 
 [HTTP host header]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Host
 [Envoy route matching]: https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_conn_man/route_matching
diff --git a/docs/sources/shared/flow/reference/components/otelcol-grpc-balancer-name.md b/docs/sources/shared/flow/reference/components/otelcol-grpc-balancer-name.md
index a735acdf4534..4c30602ad437 100644
--- a/docs/sources/shared/flow/reference/components/otelcol-grpc-balancer-name.md
+++ b/docs/sources/shared/flow/reference/components/otelcol-grpc-balancer-name.md
@@ -10,11 +10,9 @@ headless: true
 ---
 
 The supported values for `balancer_name` are listed in the gRPC documentation on [Load balancing][]:
-* `pick_first`: Tries to connect to the first address, uses it for all RPCs if it connects, 
-  or tries the next address if it fails (and keeps doing that until one connection is successful). 
+* `pick_first`: Tries to connect to the first address, uses it for all RPCs if it connects, or tries the next address if it fails (and keeps doing that until one connection is successful).
   Because of this, all the RPCs will be sent to the same backend.
-* `round_robin`: Connects to all the addresses it sees, and sends an RPC to each backend one at a time in order. 
-  For example, the first RPC is sent to backend-1, the second RPC is sent to backend-2, 
-  and the third RPC is sent to backend-1.
+* `round_robin`: Connects to all the addresses it sees and sends an RPC to each backend one at a time in order.
+  For example, the first RPC is sent to backend-1, the second RPC is sent to backend-2, and the third RPC is sent to backend-1.
 
 [Load balancing]: https://github.com/grpc/grpc-go/blob/master/examples/features/load_balancing/README.md#pick_first
diff --git a/docs/sources/shared/flow/reference/components/otelcol-queue-block.md b/docs/sources/shared/flow/reference/components/otelcol-queue-block.md
index ec26580ae2e3..09bbf8205a44 100644
--- a/docs/sources/shared/flow/reference/components/otelcol-queue-block.md
+++ b/docs/sources/shared/flow/reference/components/otelcol-queue-block.md
@@ -12,23 +12,18 @@ headless: true
 
 The following arguments are supported:
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`enabled` | `boolean` | Enables an in-memory buffer before sending data to the client. | `true` | no
-`num_consumers` | `number` | Number of readers to send batches written to the queue in parallel. | `10` | no
-`queue_size` | `number` | Maximum number of unwritten batches allowed in the queue at once. | `5000` | no
+Name            | Type      | Description                                                                | Default | Required
+----------------|-----------|----------------------------------------------------------------------------|---------|---------
+`enabled`       | `boolean` | Enables an in-memory buffer before sending data to the client.             | `true`  | no
+`num_consumers` | `number`  | Number of readers to send batches written to the queue in parallel.        | `10`    | no
+`queue_size`    | `number`  | Maximum number of unwritten batches allowed in the queue at the same time. | `5000`  | no
 
-When `enabled` is `true`, data is first written to an in-memory buffer before
-sending it to the configured server. Batches sent to the component's `input`
-exported field are added to the buffer as long as the number of unsent batches
-does not exceed the configured `queue_size`.
+When `enabled` is `true`, data is first written to an in-memory buffer before sending it to the configured server.
+Batches sent to the component's `input` exported field are added to the buffer as long as the number of unsent batches doesn't exceed the configured `queue_size`.
 
-`queue_size` is used to determine how long an endpoint outage is tolerated for.
-Assuming 100 requests/second, the default queue size `5000` provides about 50
-seconds of outage tolerance. To calculate the correct value for `queue_size`,
-multiply the average number of outgoing requests per second by the amount of
-time in seconds that outages should be tolerated for.
+`queue_size` determines how long an endpoint outage is tolerated.
+Assuming 100 requests/second, the default queue size `5000` provides about 50 seconds of outage tolerance.
+To calculate the correct value for `queue_size`, multiply the average number of outgoing requests per second by the time in seconds that outages are tolerated.
 
-The `num_consumers` argument controls how many readers read from the buffer and
-send data in parallel. Larger values of `num_consumers` allow data to be sent
-more quickly at the expense of increased network traffic.
+The `num_consumers` argument controls how many readers read from the buffer and send data in parallel.
+Larger values of `num_consumers` allow data to be sent more quickly at the expense of increased network traffic.
diff --git a/docs/sources/shared/flow/reference/components/otelcol-retry-block.md b/docs/sources/shared/flow/reference/components/otelcol-retry-block.md
index 70dce88aa63e..546947f12cd9 100644
--- a/docs/sources/shared/flow/reference/components/otelcol-retry-block.md
+++ b/docs/sources/shared/flow/reference/components/otelcol-retry-block.md
@@ -12,28 +12,22 @@ headless: true
 
 The following arguments are supported:
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`enabled` | `boolean` | Enables retrying failed requests. | `true` | no
-`initial_interval` | `duration` | Initial time to wait before retrying a failed request. | `"5s"` | no
-`randomization_factor` | `number` | Factor to randomize wait time before retrying. | `0.5` | no
-`multiplier` | `number` | Factor to grow wait time before retrying. | `1.5` | no
-`max_interval` | `duration` | Maximum time to wait between retries. | `"30s"` | no
-`max_elapsed_time` | `duration` | Maximum amount of time to wait before discarding a failed batch. | `"5m"` | no
+Name                   | Type       | Description                                            | Default | Required
+-----------------------|------------|--------------------------------------------------------|---------|---------
+`enabled`              | `boolean`  | Enables retrying failed requests.                      | `true`  | no
+`initial_interval`     | `duration` | Initial time to wait before retrying a failed request. | `"5s"`  | no
+`max_elapsed_time`     | `duration` | Maximum time to wait before discarding a failed batch. | `"5m"`  | no
+`max_interval`         | `duration` | Maximum time to wait between retries.                  | `"30s"` | no
+`multiplier`           | `number`   | Factor to grow wait time before retrying.              | `1.5`   | no
+`randomization_factor` | `number`   | Factor to randomize wait time before retrying.         | `0.5`   | no
 
 When `enabled` is `true`, failed batches are retried after a given interval.
-The `initial_interval` argument specifies how long to wait before the first
-retry attempt. If requests continue to fail, the time to wait before retrying
-increases by the factor specified by the `multiplier` argument, which must be
-greater than `1.0`. The `max_interval` argument specifies the upper bound of
-how long to wait between retries.
+The `initial_interval` argument specifies how long to wait before the first retry attempt.
+If requests continue to fail, the time to wait before retrying increases by the factor specified by the `multiplier` argument, which must be greater than `1.0`.
+The `max_interval` argument specifies the upper bound of how long to wait between retries.
 
 The `randomization_factor` argument is useful for adding jitter between retrying agents.
-If `randomization_factor` is greater than `0`, the wait time before retries is
-multiplied by a random factor in the range 
-`[ I - randomization_factor * I, I + randomization_factor * I]`, 
-where `I` is the current interval.
+If `randomization_factor` is greater than `0`, the wait time before retries is multiplied by a random factor in the range `[ I - randomization_factor * I, I + randomization_factor * I]`, where `I` is the current interval.
 
-If a batch has not sent successfully, it is discarded after the time specified
-by `max_elapsed_time` elapses. If `max_elapsed_time` is set to `"0s"`, failed
-requests are retried forever until they succeed.
+If a batch hasn't been sent successfully, it is discarded after the time specified by `max_elapsed_time` elapses.
+If `max_elapsed_time` is set to `"0s"`, failed requests are retried forever until they succeed.
diff --git a/docs/sources/shared/flow/reference/components/otelcol-tls-config-block.md b/docs/sources/shared/flow/reference/components/otelcol-tls-config-block.md
index 0e35f4f8fd8c..caf4d45001ae 100644
--- a/docs/sources/shared/flow/reference/components/otelcol-tls-config-block.md
+++ b/docs/sources/shared/flow/reference/components/otelcol-tls-config-block.md
@@ -12,30 +12,29 @@ headless: true
 
 The following arguments are supported:
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`ca_pem` | `string` | CA PEM-encoded text to validate the server with. | | no
-`ca_file` | `string` | Path to the CA file. | | no
-`cert_pem` | `string` | Certificate PEM-encoded text for client authentication. | | no
-`cert_file` | `string` | Path to the TLS certificate. | | no
-`key_pem` | `secret` | Key PEM-encoded text for client authentication. | | no
-`key_file` | `string` | Path to the TLS certificate key. | | no
-`min_version` | `string` | Minimum acceptable TLS version for connections. | `"TLS 1.2"` | no
-`max_version` | `string` | Maximum acceptable TLS version for connections. | `"TLS 1.3"` | no
-`reload_interval` | `duration` | The duration after which the certificate will be reloaded. | `"0s"` | no
-`insecure` | `boolean` | Disables TLS when connecting to the configured server. | | no
-`insecure_skip_verify` | `boolean` | Ignores insecure server TLS certificates. | | no
-`server_name` | `string` | Verifies the hostname of server certificates when set. | | no
+Name                   | Type       | Description                                             | Default     | Required
+-----------------------|------------|---------------------------------------------------------|-------------|---------
+`ca_file`              | `string`   | Path to the CA file.                                    |             | no
+`ca_pem`               | `string`   | CA PEM-encoded text to validate the server with.        |             | no
+`cert_file`            | `string`   | Path to the TLS certificate.                            |             | no
+`cert_pem`             | `string`   | Certificate PEM-encoded text for client authentication. |             | no
+`insecure_skip_verify` | `boolean`  | Ignores insecure server TLS certificates.               |             | no
+`insecure`             | `boolean`  | Disables TLS when connecting to the configured server.  |             | no
+`key_file`             | `string`   | Path to the TLS certificate key.                        |             | no
+`key_pem`              | `secret`   | Key PEM-encoded text for client authentication.         |             | no
+`max_version`          | `string`   | Maximum acceptable TLS version for connections.         | `"TLS 1.3"` | no
+`min_version`          | `string`   | Minimum acceptable TLS version for connections.         | `"TLS 1.2"` | no
+`reload_interval`      | `duration` | The duration after which the certificate is reloaded.   | `"0s"`      | no
+`server_name`          | `string`   | Verifies the hostname of server certificates when set.  |             | no
 
-If the server doesn't support TLS, the tls block must be provided with the
-`insecure` argument set to `true`. To disable `tls` for connections to the
-server, set the `insecure` argument to `true`.
+If the server doesn't support TLS, you must set the `insecure` argument to `true`.
 
-If `reload_interval` is set to `"0s"`, the certificate will never be reloaded.
+To disable `tls` for connections to the server, set the `insecure` argument to `true`.
 
-The following pairs of arguments are mutually exclusive and cannot both be set
-simultaneously:
+If `reload_interval` is set to `"0s"`, the certificate never reloaded.
+
+The following pairs of arguments are mutually exclusive and can't both be set simultaneously:
 
 * `ca_pem` and `ca_file`
 * `cert_pem` and `cert_file`
-* `key_pem` and `key_file`
\ No newline at end of file
+* `key_pem` and `key_file`
diff --git a/docs/sources/shared/flow/reference/components/output-block-logs.md b/docs/sources/shared/flow/reference/components/output-block-logs.md
index 2967d6be3d5d..fbdc89136294 100644
--- a/docs/sources/shared/flow/reference/components/output-block-logs.md
+++ b/docs/sources/shared/flow/reference/components/output-block-logs.md
@@ -10,15 +10,14 @@ description: Shared content, output block logs
 headless: true
 ---
 
-The `output` block configures a set of components to forward resulting
-telemetry data to.
+The `output` block configures a set of components to forward resulting telemetry data to.
 
 The following arguments are supported:
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`logs` | `list(otelcol.Consumer)` | List of consumers to send logs to. | `[]` | no
+Name   | Type                     | Description                        | Default | Required
+-------|--------------------------|------------------------------------|---------|---------
+`logs` | `list(otelcol.Consumer)` | List of consumers to send logs to. | `[]`    | no
 
-The `output` block must be specified, but all of its arguments are optional. By
-default, telemetry data is dropped. To send telemetry data to other components,
-configure the `logs` argument accordingly.
+You must specify the `output` block, but all its arguments are optional.
+By default, telemetry data is dropped.
+Configure the `logs` argument accordingly to send telemetry data to other components, .
diff --git a/docs/sources/shared/flow/reference/components/output-block-metrics.md b/docs/sources/shared/flow/reference/components/output-block-metrics.md
index 6adc39be1e12..25818897cab7 100644
--- a/docs/sources/shared/flow/reference/components/output-block-metrics.md
+++ b/docs/sources/shared/flow/reference/components/output-block-metrics.md
@@ -9,8 +9,7 @@ description: Shared content, output block metrics
 headless: true
 ---
 
-The `output` block configures a set of components to forward resulting
-telemetry data to.
+The `output` block configures a set of components to forward resulting telemetry data to.
 
 The following arguments are supported:
 
@@ -18,6 +17,6 @@ Name | Type | Description | Default | Required
 ---- | ---- | ----------- | ------- | --------
 `metrics` | `list(otelcol.Consumer)` | List of consumers to send metrics to. | `[]` | no
 
-The `output` block must be specified, but all of its arguments are optional. By
-default, telemetry data is dropped. To send telemetry data to other components,
-configure the `metrics` argument accordingly.
+You must specify the `output` block, but all its arguments are optional.
+By default, telemetry data is dropped.
+Configure the `metrics` argument accordingly to send telemetry data to other components.
diff --git a/docs/sources/shared/flow/reference/components/output-block-traces.md b/docs/sources/shared/flow/reference/components/output-block-traces.md
index 18635a1be997..124f42115d59 100644
--- a/docs/sources/shared/flow/reference/components/output-block-traces.md
+++ b/docs/sources/shared/flow/reference/components/output-block-traces.md
@@ -10,15 +10,14 @@ description: Shared content, output block traces
 headless: true
 ---
 
-The `output` block configures a set of components to forward resulting
-telemetry data to.
+The `output` block configures a set of components to forward resulting telemetry data to.
 
 The following arguments are supported:
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`traces` | `list(otelcol.Consumer)` | List of consumers to send traces to. | `[]` | no
+Name     | Type                     | Description                          | Default | Required
+---------|--------------------------|--------------------------------------|---------|---------
+`traces` | `list(otelcol.Consumer)` | List of consumers to send traces to. | `[]`    | no
 
-The `output` block must be specified, but all of its arguments are optional. By
-default, telemetry data is dropped. To send telemetry data to other components,
-configure the `traces` argument accordingly.
+You must specify the `output` block, but all its arguments are optional.
+By default, telemetry data is dropped.
+Configure the `traces` argument accordingly to send telemetry data to other components.
diff --git a/docs/sources/shared/flow/reference/components/output-block.md b/docs/sources/shared/flow/reference/components/output-block.md
index 382de1c8e4b8..c3ad30e7826a 100644
--- a/docs/sources/shared/flow/reference/components/output-block.md
+++ b/docs/sources/shared/flow/reference/components/output-block.md
@@ -10,17 +10,16 @@ description: Shared content, output block
 headless: true
 ---
 
-The `output` block configures a set of components to forward resulting
-telemetry data to.
+The `output` block configures a set of components to forward resulting telemetry data to.
 
 The following arguments are supported:
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`metrics` | `list(otelcol.Consumer)` | List of consumers to send metrics to. | `[]` | no
-`logs` | `list(otelcol.Consumer)` | List of consumers to send logs to. | `[]` | no
-`traces` | `list(otelcol.Consumer)` | List of consumers to send traces to. | `[]` | no
+Name      | Type                     | Description                           | Default | Required
+----------|--------------------------|---------------------------------------|---------|---------
+`logs`    | `list(otelcol.Consumer)` | List of consumers to send logs to.    | `[]`    | no
+`metrics` | `list(otelcol.Consumer)` | List of consumers to send metrics to. | `[]`    | no
+`traces`  | `list(otelcol.Consumer)` | List of consumers to send traces to.  | `[]`    | no
 
-The `output` block must be specified, but all of its arguments are optional. By
-default, telemetry data is dropped. To send telemetry data to other components,
-configure the `metrics`, `logs`, and `traces` arguments accordingly.
+You must specify the `output` block, but all its arguments are optional.
+By default, telemetry data is dropped.
+Configure the `metrics`, `logs`, and `traces` arguments accordingly to send telemetry data to other components.
diff --git a/docs/sources/shared/flow/reference/components/prom-operator-scrape.md b/docs/sources/shared/flow/reference/components/prom-operator-scrape.md
index 0a32c9a58796..156198d17b76 100644
--- a/docs/sources/shared/flow/reference/components/prom-operator-scrape.md
+++ b/docs/sources/shared/flow/reference/components/prom-operator-scrape.md
@@ -8,7 +8,7 @@ description: Shared content, prom operator scrape
 headless: true
 ---
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`default_scrape_interval` | `duration` | The default interval between scraping targets. Used as the default if the target resource does not provide a scrape interval. | `1m` | no
-`default_scrape_timeout` | `duration` | The default timeout for scrape requests. Used as the default if the target resource does not provide a scrape timeout. | `10s` | no
+Name                      | Type       | Description                                                                                                                  | Default | Required
+--------------------------|------------|------------------------------------------------------------------------------------------------------------------------------|---------|---------
+`default_scrape_interval` | `duration` | The default interval between scraping targets. Used as the default if the target resource doesn't provide a scrape interval. | `1m`    | no
+`default_scrape_timeout`  | `duration` | The default timeout for scrape requests. Used as the default if the target resource doesn't provide a scrape timeout.        | `10s`   | no
diff --git a/docs/sources/shared/flow/reference/components/rule-block-logs.md b/docs/sources/shared/flow/reference/components/rule-block-logs.md
index f585dd057e87..180bb7e18167 100644
--- a/docs/sources/shared/flow/reference/components/rule-block-logs.md
+++ b/docs/sources/shared/flow/reference/components/rule-block-logs.md
@@ -10,36 +10,36 @@ description: Shared content, rule block logs
 headless: true
 ---
 
-The `rule` block contains the definition of any relabeling rules that can be
-applied to an input log. If more than one `rule` block is defined, the
-transformations are applied in top-down order.
+The `rule` block contains the definition of any relabeling rules that can be applied to an input log.
+The transformations are applied in top-down order if more than one `rule` block is defined.
 
-The following arguments can be used to configure a `rule`. All arguments are
-optional. Omitted fields take their default values.
+You can use the following arguments to configure a `rule`.
+All arguments are optional. Omitted fields take their default values.
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`source_labels` | `list(string)` | The list of labels whose values are to be selected. Their content is concatenated using the `separator` and matched against `regex`. | | no
-`separator`     | `string`       | The separator used to concatenate the values present in `source_labels`. | ; | no
+Name            | Type           | Description                                                                                                                          | Default | Required
+----------------|----------------|--------------------------------------------------------------------------------------------------------------------------------------|---------|---------
+`action`        | `string`       | The relabeling action to perform.                                                                                                    | replace | no
+`modulus`       | `uint`         | A positive integer used to calculate the modulus of the hashed source label values.                                                  |         | no
 `regex`         | `string`       | A valid RE2 expression with support for parenthesized capture groups. Used to match the extracted value from the combination of the `source_label` and `separator` fields or filter labels during the `labelkeep/labeldrop/labelmap` actions. | `(.*)` | no
-`modulus`       | `uint`         | A positive integer used to calculate the modulus of the hashed source label values. | | no
-`target_label`  | `string`       | Label to which the resulting value will be written to. | | no
-`replacement`   | `string`       | The value against which a regex replace is performed, if the regex matches the extracted value. Supports previously captured groups. | $1 | no
-`action`        | `string`       | The relabeling action to perform. | replace | no
+`replacement`   | `string`       | The value against which a regular expression replace is performed if the regular expression matches the extracted value. Supports previously captured groups. | `"$1"`      | no
+`separator`     | `string`       | The separator used to concatenate the values present in `source_labels`.                                                             | ;       | no
+`source_labels` | `list(string)` | The list of labels whose values are to be selected. Their content is concatenated using the `separator` and matched against `regex`. |         | no
+`target_label`  | `string`       | Label to which the resulting value is written to.                                                                               |         | no
 
-Here's a list of the available actions, along with a brief description of their usage.
+You can use the following actions:
 
-* `replace`   - Matches `regex` to the concatenated labels. If there's a match, it replaces the content of the `target_label` using the contents of the `replacement` field.
-* `keep`      - Keeps logs where `regex` matches the string extracted using the `source_labels` and `separator`.
 * `drop`      - Drops logs where `regex` matches the string extracted using the `source_labels` and `separator`.
-* `hashmod`   - Hashes the concatenated labels, calculates its modulo `modulus` and writes the result to the `target_label`.
-* `labelmap`  - Matches `regex` against all label names. Any labels that match are renamed according to the contents of the `replacement` field.
-* `labeldrop` - Matches `regex` against all label names. Any labels that match are removed from the logs's label set.
-* `labelkeep` - Matches `regex` against all label names. Any labels that don't match are removed from the logs's label set.
-* `keepequal` - Drop targets for which the concatenated `source_labels` do not match `target_label`.
 * `dropequal` - Drop targets for which the concatenated `source_labels` do match `target_label`.
+* `hashmod`   - Hashes the concatenated labels, calculates its modulo `modulus`, and writes the result to the `target_label`.
+* `keep`      - Keeps logs where `regex` matches the string extracted using the `source_labels` and `separator`.
+* `keepequal` - Drop targets for which the concatenated `source_labels` do not match `target_label`.
+* `labeldrop` - Matches `regex` against all label names. Any labels that match are removed from the log's label set.
+* `labelkeep` - Matches `regex` against all label names. Any labels that don't match are removed from the log's label set.
+* `labelmap`  - Matches `regex` against all label names. Any labels that match are renamed according to the contents of the `replacement` field.
 * `lowercase` - Sets `target_label` to the lowercase form of the concatenated `source_labels`.
+* `replace`   - Matches `regex` to the concatenated labels. If there's a match, it replaces the content of the `target_label` using the contents of the `replacement` field.
 * `uppercase` - Sets `target_label` to the uppercase form of the concatenated `source_labels`.
 
-Finally, note that the regex capture groups can be referred to using either the
-`$CAPTURE_GROUP_NUMBER` or `${CAPTURE_GROUP_NUMBER}` notation.
+{{% admonition type="note" %}}
+The regular expression capture groups can be referred to using either the `$CAPTURE_GROUP_NUMBER` or `${CAPTURE_GROUP_NUMBER}` notation.
+{{% /admonition %}}
diff --git a/docs/sources/shared/flow/reference/components/rule-block.md b/docs/sources/shared/flow/reference/components/rule-block.md
index 49b4f9ce9260..0b732954b18a 100644
--- a/docs/sources/shared/flow/reference/components/rule-block.md
+++ b/docs/sources/shared/flow/reference/components/rule-block.md
@@ -10,36 +10,36 @@ description: Shared content, rule block
 headless: true
 ---
 
-The `rule` block contains the definition of any relabeling rules that can be
-applied to an input metric. If more than one `rule` block is defined, the
-transformations are applied in top-down order.
+The `rule` block contains the definition of any relabeling rules that can be applied to an input metric.
+If more than one `rule` block is defined, the transformations are applied in top-down order.
 
-The following arguments can be used to configure a `rule`. All arguments are
-optional. Omitted fields take their default values.
+The following arguments can be used to configure a `rule`.
+All arguments are optional. Omitted fields take their default values.
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`source_labels` | `list(string)` | The list of labels whose values are to be selected. Their content is concatenated using the `separator` and matched against `regex`. | | no
-`separator`     | `string`       | The separator used to concatenate the values present in `source_labels`. | ; | no
+Name            | Type           | Description                                                                                                                          | Default | Required
+----------------|----------------|--------------------------------------------------------------------------------------------------------------------------------------|---------|---------
+`action`        | `string`       | The relabeling action to perform.                                                                                                    | replace | no
+`modulus`       | `uint`         | A positive integer used to calculate the modulus of the hashed source label values.                                                  |         | no
 `regex`         | `string`       | A valid RE2 expression with support for parenthesized capture groups. Used to match the extracted value from the combination of the `source_label` and `separator` fields or filter labels during the `labelkeep/labeldrop/labelmap` actions. | `(.*)` | no
-`modulus`       | `uint`         | A positive integer used to calculate the modulus of the hashed source label values. | | no
-`target_label`  | `string`       | Label to which the resulting value will be written to. | | no
-`replacement`   | `string`       | The value against which a regex replace is performed, if the regex matches the extracted value. Supports previously captured groups. | $1 | no
-`action`        | `string`       | The relabeling action to perform. | replace | no
+`replacement`   | `string`       | The value against which a regular expression replace is performed, if the regular expression matches the extracted value. Supports previously captured groups. | `"$1"`      | no
+`separator`     | `string`       | The separator used to concatenate the values present in `source_labels`.                                                             | ;       | no
+`source_labels` | `list(string)` | The list of labels whose values are to be selected. Their content is concatenated using the `separator` and matched against `regex`. |         | no
+`target_label`  | `string`       | Label to which the resulting value will be written to.                                                                               |         | no
 
-Here's a list of the available actions, along with a brief description of their usage.
+You can use the following actions:
 
-* `replace`   - Matches `regex` to the concatenated labels. If there's a match, it replaces the content of the `target_label` using the contents of the `replacement` field.
-* `keep`      - Keeps metrics where `regex` matches the string extracted using the `source_labels` and `separator`.
 * `drop`      - Drops metrics where `regex` matches the string extracted using the `source_labels` and `separator`.
+* `dropequal` - Drop targets for which the concatenated `source_labels` do match `target_label`.
 * `hashmod`   - Hashes the concatenated labels, calculates its modulo `modulus` and writes the result to the `target_label`.
-* `labelmap`  - Matches `regex` against all label names. Any labels that match are renamed according to the contents of the `replacement` field.
+* `keep`      - Keeps metrics where `regex` matches the string extracted using the `source_labels` and `separator`.
+* `keepequal` - Drop targets for which the concatenated `source_labels` do not match `target_label`.
 * `labeldrop` - Matches `regex` against all label names. Any labels that match are removed from the metric's label set.
 * `labelkeep` - Matches `regex` against all label names. Any labels that don't match are removed from the metric's label set.
-* `keepequal` - Drop targets for which the concatenated `source_labels` do not match `target_label`.
-* `dropequal` - Drop targets for which the concatenated `source_labels` do match `target_label`.
+* `labelmap`  - Matches `regex` against all label names. Any labels that match are renamed according to the contents of the `replacement` field.
 * `lowercase` - Sets `target_label` to the lowercase form of the concatenated `source_labels`.
+* `replace`   - Matches `regex` to the concatenated labels. If there's a match, it replaces the content of the `target_label` using the contents of the `replacement` field.
 * `uppercase` - Sets `target_label` to the uppercase form of the concatenated `source_labels`.
 
-Finally, note that the regex capture groups can be referred to using either the
-`$CAPTURE_GROUP_NUMBER` or `${CAPTURE_GROUP_NUMBER}` notation.
+{{% admonition type="note" %}}
+The regular expression capture groups can be referred to using either the `$CAPTURE_GROUP_NUMBER` or `${CAPTURE_GROUP_NUMBER}` notation.
+{{% /admonition %}}
diff --git a/docs/sources/shared/flow/reference/components/sigv4-block.md b/docs/sources/shared/flow/reference/components/sigv4-block.md
index 0acbc40cb67f..54598570ad83 100644
--- a/docs/sources/shared/flow/reference/components/sigv4-block.md
+++ b/docs/sources/shared/flow/reference/components/sigv4-block.md
@@ -10,13 +10,13 @@ description: Shared content, sigv4 block
 headless: true
 ---
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`region` | `string` | AWS region. | | no
-`access_key` | `string` | AWS API access key. | | no
-`secret_key` | `secret` | AWS API secret key.| | no
-`profile` | `string` | Named AWS profile used to authenticate. | | no
-`role_arn` | `string` | AWS Role ARN, an alternative to using AWS API keys. | | no
+Name         | Type     | Description                                         | Default | Required
+-------------|----------|-----------------------------------------------------|---------|---------
+`access_key` | `string` | AWS API access key.                                 |         | no
+`profile`    | `string` | Named AWS profile used to authenticate.             |         | no
+`region`     | `string` | AWS region.                                         |         | no
+`role_arn`   | `string` | AWS Role ARN, an alternative to using AWS API keys. |         | no
+`secret_key` | `secret` | AWS API secret key.                                 |         | no
 
 If `region` is left blank, the region from the default credentials chain is used.
 
diff --git a/docs/sources/shared/flow/reference/components/tls-config-block.md b/docs/sources/shared/flow/reference/components/tls-config-block.md
index 033c64ebacf2..1b92e91d0be7 100644
--- a/docs/sources/shared/flow/reference/components/tls-config-block.md
+++ b/docs/sources/shared/flow/reference/components/tls-config-block.md
@@ -10,20 +10,19 @@ description: Shared content, tls config block
 headless: true
 ---
 
-Name | Type | Description | Default | Required
----- | ---- | ----------- | ------- | --------
-`ca_pem` | `string` | CA PEM-encoded text to validate the server with. | | no
-`ca_file` | `string` | CA certificate to validate the server with. | | no
-`cert_pem` | `string` | Certificate PEM-encoded text for client authentication. | | no
-`cert_file` | `string` | Certificate file for client authentication. | | no
-`key_pem` | `secret` | Key PEM-encoded text for client authentication. | | no
-`key_file` | `string` | Key file for client authentication. | | no
-`server_name` | `string` | ServerName extension to indicate the name of the server. | | no
-`insecure_skip_verify` | `bool` | Disables validation of the server certificate. | | no
-`min_version` | `string` | Minimum acceptable TLS version. | | no
+Name                   | Type     | Description                                              | Default | Required
+-----------------------|----------|----------------------------------------------------------|---------|---------
+`ca_pem`               | `string` | CA PEM-encoded text to validate the server with.         |         | no
+`ca_file`              | `string` | CA certificate to validate the server with.              |         | no
+`cert_pem`             | `string` | Certificate PEM-encoded text for client authentication.  |         | no
+`cert_file`            | `string` | Certificate file for client authentication.              |         | no
+`insecure_skip_verify` | `bool`   | Disables validation of the server certificate.           |         | no
+`key_file`             | `string` | Key file for client authentication.                      |         | no
+`key_pem`              | `secret` | Key PEM-encoded text for client authentication.          |         | no
+`min_version`          | `string` | Minimum acceptable TLS version.                          |         | no
+`server_name`          | `string` | ServerName extension to indicate the name of the server. |         | no
 
-The following pairs of arguments are mutually exclusive and cannot both be set
-simultaneously:
+The following pairs of arguments are mutually exclusive and can't both be set simultaneously:
 
 * `ca_pem` and `ca_file`
 * `cert_pem` and `cert_file`