From 3dec83af5094118a9c4faf9a6cd6409d84f73fd5 Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Wed, 15 Jan 2025 15:44:16 -0800
Subject: [PATCH 1/6] Update EC2 topic

---
 .../components/discovery/discovery.ec2.md     | 106 +++++++++---------
 1 file changed, 55 insertions(+), 51 deletions(-)

diff --git a/docs/sources/reference/components/discovery/discovery.ec2.md b/docs/sources/reference/components/discovery/discovery.ec2.md
index 4fb9f98d01..a569ca8075 100644
--- a/docs/sources/reference/components/discovery/discovery.ec2.md
+++ b/docs/sources/reference/components/discovery/discovery.ec2.md
@@ -8,14 +8,15 @@ title: discovery.ec2
 
 # discovery.ec2
 
-`discovery.ec2` lets you retrieve scrape targets from EC2 instances. The private IP address is used by default, but you can change it to the public IP address using relabeling.
+`discovery.ec2` lets you retrieve scrape targets from EC2 instances.
+The private IP address is used by default, but you can change it to the public IP address using relabeling.
 
 The IAM credentials used must have the `ec2:DescribeInstances` permission to discover scrape targets, and may optionally have the `ec2:DescribeAvailabilityZones` permission to make the availability zone ID available as a label.
 
 ## Usage
 
 ```alloy
-discovery.ec2 "LABEL" {
+discovery.ec2 "<LABEL>" {
 }
 ```
 
@@ -25,64 +26,64 @@ The following arguments are supported:
 
 Name                     | Type                | Description                                                                                                             | Default | Required
 -------------------------|---------------------|-------------------------------------------------------------------------------------------------------------------------|---------|---------
-`endpoint`               | `string`            | Custom endpoint to be used.                                                                                             |         | no
-`region`                 | `string`            | The AWS region. If blank, the region from the instance metadata is used.                                                |         | no
 `access_key`             | `string`            | The AWS API key ID. If blank, the environment variable `AWS_ACCESS_KEY_ID` is used.                                     |         | no
-`secret_key`             | `string`            | The AWS API key secret. If blank, the environment variable `AWS_SECRET_ACCESS_KEY` is used.                             |         | no
-`profile`                | `string`            | Named AWS profile used to connect to the API.                                                                           |         | no
-`role_arn`               | `string`            | AWS Role Amazon Resource Name (ARN), an alternative to using AWS API keys.                                              |         | no
-`refresh_interval`       | `string`            | Refresh interval to re-read the instance list.                                                                          | 60s     | no
-`port`                   | `int`               | The port to scrape metrics from. If using the public IP address, this must instead be specified in the relabeling rule. | 80      | no
 `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
+`endpoint`               | `string`            | Custom endpoint to be used.                                                                                             |         | 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
 `no_proxy`               | `string`            | Comma-separated list of IP addresses, CIDR notations, and domain names to exclude from proxying.                        |         | no
-`proxy_from_environment` | `bool`              | Use the proxy URL indicated by environment variables.                                                                   | `false` | no
+`port`                   | `int`               | The port to scrape metrics from. If using the public IP address, this must instead be specified in the relabeling rule. | 80      | no
+`profile`                | `string`            | Named AWS profile used to connect to the API.                                                                           |         | no
 `proxy_connect_header`   | `map(list(secret))` | Specifies headers to send to proxies during CONNECT requests.                                                           |         | no
+`proxy_from_environment` | `bool`              | Use the proxy URL indicated by environment variables.                                                                   | `false` | no
+`proxy_url`              | `string`            | HTTP proxy to send requests through.                                                                                    |         | no
+`refresh_interval`       | `string`            | Refresh interval to re-read the instance list.                                                                          | 60s     | no
+`region`                 | `string`            | The AWS region. If blank, the region from the instance metadata is used.                                                |         | no
+`role_arn`               | `string`            | AWS Role Amazon Resource Name (ARN), an alternative to using AWS API keys.                                              |         | no
+`secret_key`             | `string`            | The AWS API key secret. If blank, the environment variable `AWS_SECRET_ACCESS_KEY` is used.                             |         | no
 
  At most, one of the following can be provided:
- - [`bearer_token` argument](#arguments).
- - [`bearer_token_file` argument](#arguments).
- - [`basic_auth` block][basic_auth].
- - [`authorization` block][authorization].
- - [`oauth2` block][oauth2].
+
+* [`authorization` block][authorization].
+* [`basic_auth` block][basic_auth].
+* [`bearer_token_file` argument](#arguments).
+* [`bearer_token` argument](#arguments).
+* [`oauth2` block][oauth2].
 
  {{< docs/shared lookup="reference/components/http-client-proxy-config-description.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
 ## Blocks
 
-The following blocks are supported inside the definition of
-`discovery.ec2`:
+The following blocks are supported inside the definition of `discovery.ec2`:
 
-Hierarchy           | Block             | Description                                              | Required
---------------------|-------------------|----------------------------------------------------------|---------
-basic_auth          | [basic_auth][]    | Configure basic_auth for authenticating to the endpoint. | no
-authorization       | [authorization][] | Configure generic authorization to the endpoint.         | no
-filter              | [filter][]        | Filters discoverable resources.                          | no
-oauth2              | [oauth2][]        | Configure OAuth2 for authenticating to the endpoint.     | no
-oauth2 > tls_config | [tls_config][]    | Configure TLS settings for connecting to the endpoint.   | no
-tls_config          | [tls_config][]    | Configure TLS settings for connecting to the endpoint.   | no
+Hierarchy           | Block             | Description                                                | Required
+--------------------|-------------------|------------------------------------------------------------|---------
+authorization       | [authorization][] | Configure generic authorization to the endpoint.           | no
+basic_auth          | [basic_auth][]    | Configure `basic_auth` for authenticating to the endpoint. | no
+filter              | [filter][]        | Filters discoverable resources.                            | no
+oauth2              | [oauth2][]        | Configure OAuth2 for authenticating to the endpoint.       | no
+oauth2 > tls_config | [tls_config][]    | Configure TLS settings for connecting to the endpoint.     | no
+tls_config          | [tls_config][]    | Configure TLS settings for connecting to the endpoint.     | no
 
-[filter]: #filter-block
-[authorization]: #authorization-block
-[oauth2]: #oauth2-block
-[tls_config]: #tls_config-block
-[basic_auth]: #basic_auth-block
+[authorization]: #authorization
+[basic_auth]: #basic_auth
+[filter]: #filter
+[oauth2]: #oauth2
+[tls_config]: #tls_config
 
-### basic_auth block
+### authorization
 
-{{< docs/shared lookup="reference/components/basic-auth-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
+{{< docs/shared lookup="reference/components/authorization-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### authorization block
+### basic_auth
 
-{{< docs/shared lookup="reference/components/authorization-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
+{{< docs/shared lookup="reference/components/basic-auth-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### filter block
+### filter
 
-Filters can be used optionally to filter the instance list by other criteria.
-Available filter criteria can be found in the [Amazon EC2 documentation](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html).
+You can use filters to filter the instance list by other criteria.
+Refer to the [Amazon EC2 documentation][amazon] for more information about filters.
 
 Name     | Type           | Description                   | Default | Required
 ---------|----------------|-------------------------------|---------|---------
@@ -91,13 +92,14 @@ Name     | Type           | Description                   | Default | Required
 
 Refer to the [Filter API AWS EC2 documentation][filter api] for the list of supported filters and their descriptions.
 
+[amazon]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html
 [filter api]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_Filter.html
 
-### oauth2 block
+### oauth2
 
 {{< docs/shared lookup="reference/components/oauth2-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### tls_config block
+### tls_config
 
 {{< docs/shared lookup="reference/components/tls-config-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
@@ -105,16 +107,16 @@ Refer to the [Filter API AWS EC2 documentation][filter api] for the list of supp
 
 The following fields are exported and can be referenced by other components:
 
-Name | Type | Description
----- | ---- | -----------
+Name      | Type                | Description
+----------|---------------------|-----------------------------------
 `targets` | `list(map(string))` | The set of discovered EC2 targets.
 
 Each target includes the following labels:
 
 * `__meta_ec2_ami`: The EC2 Amazon Machine Image.
 * `__meta_ec2_architecture`: The architecture of the instance.
+* `__meta_ec2_availability_zone_id`: The availability zone ID in which the instance is running. Requires `ec2:DescribeAvailabilityZones`.
 * `__meta_ec2_availability_zone`: The availability zone in which the instance is running.
-* `__meta_ec2_availability_zone_id`: The availability zone ID in which the instance is running (requires `ec2:DescribeAvailabilityZones`).
 * `__meta_ec2_instance_id`: The EC2 instance ID.
 * `__meta_ec2_instance_lifecycle`: The lifecycle of the EC2 instance, set only for 'spot' or 'scheduled' instances, absent otherwise.
 * `__meta_ec2_instance_state`: The state of the EC2 instance.
@@ -139,11 +141,11 @@ In those cases, exported fields retain their last healthy values.
 
 ## Debug information
 
-`discovery.ec2` does not expose any component-specific debug information.
+`discovery.ec2` doesn't expose any component-specific debug information.
 
 ## Debug metrics
 
-`discovery.ec2` does not expose any component-specific debug metrics.
+`discovery.ec2` doesn't expose any component-specific debug metrics.
 
 ## Example
 
@@ -159,19 +161,21 @@ prometheus.scrape "demo" {
 
 prometheus.remote_write "demo" {
   endpoint {
-    url = PROMETHEUS_REMOTE_WRITE_URL
+    url = <PROMETHEUS_REMOTE_WRITE_URL>
 
     basic_auth {
-      username = USERNAME
-      password = PASSWORD
+      username = <USERNAME>
+      password = <PASSWORD>
     }
   }
 }
 ```
+
 Replace the following:
-  - `PROMETHEUS_REMOTE_WRITE_URL`: The URL of the Prometheus remote_write-compatible server to send metrics to.
-  - `USERNAME`: The username to use for authentication to the remote_write API.
-  - `PASSWORD`: The password to use for authentication to the remote_write API.
+
+* _`<PROMETHEUS_REMOTE_WRITE_URL>`_: The URL of the Prometheus remote_write-compatible server to send metrics to.
+* _`<USERNAME>`_: The username to use for authentication to the `remote_write` API.
+* _`<PASSWORD>`_: The password to use for authentication to the `remote_write` API.
 
 <!-- START GENERATED COMPATIBLE COMPONENTS -->
 

From 607ce55321cd324a2475a13f3d274791a6167cde Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Wed, 15 Jan 2025 15:49:40 -0800
Subject: [PATCH 2/6] Updated eureka topic

---
 .../components/discovery/discovery.eureka.md  | 110 +++++++++---------
 1 file changed, 56 insertions(+), 54 deletions(-)

diff --git a/docs/sources/reference/components/discovery/discovery.eureka.md b/docs/sources/reference/components/discovery/discovery.eureka.md
index e9ccf80dee..08a80d719d 100644
--- a/docs/sources/reference/components/discovery/discovery.eureka.md
+++ b/docs/sources/reference/components/discovery/discovery.eureka.md
@@ -15,8 +15,8 @@ title: discovery.eureka
 ## Usage
 
 ```alloy
-discovery.eureka "LABEL" {
-    server = SERVER
+discovery.eureka "<LABEL>" {
+    server = <SERVER>
 }
 ```
 
@@ -27,61 +27,61 @@ The following arguments are supported:
 Name                     | Type                | Description                                                                                      | Default | Required
 -------------------------|---------------------|--------------------------------------------------------------------------------------------------|---------|---------
 `server`                 | `string`            | Eureka server URL.                                                                               |         | yes
-`refresh_interval`       | `duration`          | Interval at which to refresh the list of targets.                                                | `30s`   | no
 `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
 `no_proxy`               | `string`            | Comma-separated list of IP addresses, CIDR notations, and domain names to exclude from proxying. |         | no
-`proxy_from_environment` | `bool`              | Use the proxy URL indicated by environment variables.                                            | `false` | no
 `proxy_connect_header`   | `map(list(secret))` | Specifies headers to send to proxies during CONNECT requests.                                    |         | no
+`proxy_from_environment` | `bool`              | Use the proxy URL indicated by environment variables.                                            | `false` | no
+`proxy_url`              | `string`            | HTTP proxy to send requests through.                                                             |         | no
+`refresh_interval`       | `duration`          | Interval at which to refresh the list of targets.                                                | `30s`   | no
 
  At most, one of the following can be provided:
- - [`bearer_token` argument](#arguments).
- - [`bearer_token_file` argument](#arguments).
- - [`basic_auth` block][basic_auth].
- - [`authorization` block][authorization].
- - [`oauth2` block][oauth2].
+
+* [`authorization` block][authorization].
+* [`basic_auth` block][basic_auth].
+* [`bearer_token_file` argument][arguments].
+* [`bearer_token` argument][arguments].
+* [`oauth2` block][oauth2].
 
 [arguments]: #arguments
 
 {{< docs/shared lookup="reference/components/http-client-proxy-config-description.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
 ## Blocks
-The following blocks are supported inside the definition of
-`discovery.eureka`:
-
-Hierarchy           | Block             | Description                                              | Required
---------------------|-------------------|----------------------------------------------------------|---------
-basic_auth          | [basic_auth][]    | Configure basic_auth for authenticating to the endpoint. | no
-authorization       | [authorization][] | Configure generic authorization to the endpoint.         | no
-oauth2              | [oauth2][]        | Configure OAuth2 for authenticating to the endpoint.     | no
-oauth2 > tls_config | [tls_config][]    | Configure TLS settings for connecting to the endpoint.   | no
-tls_config          | [tls_config][]    | Configure TLS settings for connecting to the endpoint.   | no
 
-The `>` symbol indicates deeper levels of nesting. For example,
-`oauth2 > tls_config` refers to a `tls_config` block defined inside
-an `oauth2` block.
+The following blocks are supported inside the definition of `discovery.eureka`:
 
-[basic_auth]: #basic_auth-block
-[authorization]: #authorization-block
-[oauth2]: #oauth2-block
-[tls_config]: #tls_config-block
+Hierarchy           | Block             | Description                                                | Required
+--------------------|-------------------|------------------------------------------------------------|---------
+authorization       | [authorization][] | Configure generic authorization to the endpoint.           | no
+basic_auth          | [basic_auth][]    | Configure `basic_auth` for authenticating to the endpoint. | no
+oauth2              | [oauth2][]        | Configure OAuth2 for authenticating to the endpoint.       | no
+oauth2 > tls_config | [tls_config][]    | Configure TLS settings for connecting to the endpoint.     | no
+tls_config          | [tls_config][]    | Configure TLS settings for connecting to the endpoint.     | no
 
-### basic_auth block
+The `>` symbol indicates deeper levels of nesting.
+For example, `oauth2 > tls_config` refers to a `tls_config` block defined inside an `oauth2` block.
 
-{{< docs/shared lookup="reference/components/basic-auth-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
+[authorization]: #authorization
+[basic_auth]: #basic_auth
+[oauth2]: #oauth2
+[tls_config]: #tls_config
 
-### authorization block
+### authorization
 
 {{< docs/shared lookup="reference/components/authorization-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### oauth2 block
+### basic_auth
+
+{{< docs/shared lookup="reference/components/basic-auth-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
+
+### oauth2
 
 {{< docs/shared lookup="reference/components/oauth2-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### tls_config block
+### tls_config
 
 {{< docs/shared lookup="reference/components/tls-config-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
@@ -95,24 +95,24 @@ Name      | Type                | Description
 
 Each target includes the following labels:
 
-* `__meta_eureka_app_name`
-* `__meta_eureka_app_instance_hostname`
-* `__meta_eureka_app_instance_homepage_url`
-* `__meta_eureka_app_instance_statuspage_url`
+* `__meta_eureka_app_instance_country_id`
+* `__meta_eureka_app_instance_datacenterinfo_metadata_`
+* `__meta_eureka_app_instance_datacenterinfo_name`
 * `__meta_eureka_app_instance_healthcheck_url`
+* `__meta_eureka_app_instance_homepage_url`
+* `__meta_eureka_app_instance_hostname`
+* `__meta_eureka_app_instance_id`
 * `__meta_eureka_app_instance_ip_addr`
-* `__meta_eureka_app_instance_vip_address`
-* `__meta_eureka_app_instance_secure_vip_address`
-* `__meta_eureka_app_instance_status`
-* `__meta_eureka_app_instance_port`
+* `__meta_eureka_app_instance_metadata_`
 * `__meta_eureka_app_instance_port_enabled`
-* `__meta_eureka_app_instance_secure_port`
+* `__meta_eureka_app_instance_port`
 * `__meta_eureka_app_instance_secure_port_enabled`
-* `__meta_eureka_app_instance_datacenterinfo_name`
-* `__meta_eureka_app_instance_datacenterinfo_metadata_`
-* `__meta_eureka_app_instance_country_id`
-* `__meta_eureka_app_instance_id`
-* `__meta_eureka_app_instance_metadata_`
+* `__meta_eureka_app_instance_secure_port`
+* `__meta_eureka_app_instance_secure_vip_address`
+* `__meta_eureka_app_instance_status`
+* `__meta_eureka_app_instance_statuspage_url`
+* `__meta_eureka_app_instance_vip_address`
+* `__meta_eureka_app_name`
 
 ## Component health
 
@@ -121,11 +121,11 @@ In those cases, exported fields retain their last healthy values.
 
 ## Debug information
 
-`discovery.eureka` does not expose any component-specific debug information.
+`discovery.eureka` doesn't expose any component-specific debug information.
 
 ## Debug metrics
 
-`discovery.eureka` does not expose any component-specific debug metrics.
+`discovery.eureka` doesn't expose any component-specific debug metrics.
 
 ## Example
 
@@ -141,19 +141,21 @@ prometheus.scrape "demo" {
 
 prometheus.remote_write "demo" {
   endpoint {
-    url = PROMETHEUS_REMOTE_WRITE_URL
+    url = <PROMETHEUS_REMOTE_WRITE_URL>
 
     basic_auth {
-      username = USERNAME
-      password = PASSWORD
+      username = <USERNAME>
+      password = <PASSWORD>
     }
   }
 }
 ```
+
 Replace the following:
-  - `PROMETHEUS_REMOTE_WRITE_URL`: The URL of the Prometheus remote_write-compatible server to send metrics to.
-  - `USERNAME`: The username to use for authentication to the remote_write API.
-  - `PASSWORD`: The password to use for authentication to the remote_write API.
+
+* _`<PROMETHEUS_REMOTE_WRITE_URL>`_: The URL of the Prometheus remote_write-compatible server to send metrics to.
+* _`<USERNAME>`_: The username to use for authentication to the `remote_write` API.
+* _`<PASSWORD>`_: The password to use for authentication to the `remote_write` API.
 
 <!-- START GENERATED COMPATIBLE COMPONENTS -->
 

From aa9c4181239275f16508109e6094f4a1c43ef54a Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Wed, 15 Jan 2025 15:54:41 -0800
Subject: [PATCH 3/6] Update file topic

---
 .../components/discovery/discovery.file.md    | 37 ++++++++++---------
 1 file changed, 20 insertions(+), 17 deletions(-)

diff --git a/docs/sources/reference/components/discovery/discovery.file.md b/docs/sources/reference/components/discovery/discovery.file.md
index d292021083..2d88c7f74a 100644
--- a/docs/sources/reference/components/discovery/discovery.file.md
+++ b/docs/sources/reference/components/discovery/discovery.file.md
@@ -21,8 +21,8 @@ If you are trying to discover files on the local filesystem rather than scrape t
 ## Usage
 
 ```alloy
-discovery.file "LABEL" {
-  files = [FILE_PATH_1, FILE_PATH_2, ...]
+discovery.file "<LABEL>" {
+  files = [<FILE_PATH_1>, <FILE_PATH_2>, ...]
 }
 ```
 
@@ -35,7 +35,7 @@ Name               | Type           | Description                              |
 `files`            | `list(string)` | Files to read and discover targets from. |         | yes
 `refresh_interval` | `duration`     | How often to sync targets.               | "5m"    | no
 
-The last path segment of each element in `files` may contain a single * that matches any character sequence, e.g. `my/path/tg_*.json`.
+The last path segment of each element in `files` may contain a single `*` that matches any character sequence, for example, `my/path/tg_*.json`.
 
 ## Exported fields
 
@@ -56,15 +56,16 @@ In those cases, exported fields retain their last healthy values.
 
 ## Debug information
 
-`discovery.file` does not expose any component-specific debug information.
+`discovery.file` doesn't expose any component-specific debug information.
 
 ## Debug metrics
 
-`discovery.file` does not expose any component-specific debug metrics.
+`discovery.file` doesn't expose any component-specific debug metrics.
 
 ## Examples
 
 ### Example target files
+
 ```json
 [
   {
@@ -110,20 +111,21 @@ prometheus.scrape "default" {
 
 prometheus.remote_write "demo" {
   endpoint {
-    url = PROMETHEUS_REMOTE_WRITE_URL
+    url = <PROMETHEUS_REMOTE_WRITE_URL>
 
     basic_auth {
-      username = USERNAME
-      password = PASSWORD
+      username = <USERNAME>
+      password = <PASSWORD>
     }
   }
 }
 ```
 
 Replace the following:
-  - `PROMETHEUS_REMOTE_WRITE_URL`: The URL of the Prometheus remote_write-compatible server to send metrics to.
-  - `USERNAME`: The username to use for authentication to the remote_write API.
-  - `PASSWORD`: The password to use for authentication to the remote_write API.
+
+* _`<PROMETHEUS_REMOTE_WRITE_URL>`_: The URL of the Prometheus remote_write-compatible server to send metrics to.
+* _`<USERNAME>`_: The username to use for authentication to the `remote_write` API.
+* _`<PASSWORD>`_: The password to use for authentication to the `remote_write` API.
 
 ### File discovery with retained file path label
 
@@ -151,20 +153,21 @@ prometheus.scrape "default" {
 
 prometheus.remote_write "demo" {
   endpoint {
-    url = PROMETHEUS_REMOTE_WRITE_URL
+    url = <PROMETHEUS_REMOTE_WRITE_URL>
 
     basic_auth {
-      username = USERNAME
-      password = PASSWORD
+      username = <USERNAME>
+      password = <PASSWORD>
     }
   }
 }
 ```
 
 Replace the following:
-  - `PROMETHEUS_REMOTE_WRITE_URL`: The URL of the Prometheus remote_write-compatible server to send metrics to.
-  - `USERNAME`: The username to use for authentication to the remote_write API.
-  - `PASSWORD`: The password to use for authentication to the remote_write API.
+
+* _`<PROMETHEUS_REMOTE_WRITE_URL>`_: The URL of the Prometheus remote_write-compatible server to send metrics to.
+* _`<USERNAME>`_: The username to use for authentication to the `remote_write` API.
+* _`<PASSWORD>`_: The password to use for authentication to the `remote_write` API.
 
 <!-- START GENERATED COMPATIBLE COMPONENTS -->
 

From 70e6861f021d79fe0d19db651901a74e76eb0c13 Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Wed, 15 Jan 2025 15:59:39 -0800
Subject: [PATCH 4/6] Update GCE topic

---
 .../components/discovery/discovery.gce.md     | 55 ++++++++++---------
 1 file changed, 28 insertions(+), 27 deletions(-)

diff --git a/docs/sources/reference/components/discovery/discovery.gce.md b/docs/sources/reference/components/discovery/discovery.gce.md
index b28d240b81..c0bf03d11c 100644
--- a/docs/sources/reference/components/discovery/discovery.gce.md
+++ b/docs/sources/reference/components/discovery/discovery.gce.md
@@ -25,9 +25,9 @@ If running outside of GCE make sure to create an appropriate service account and
 ## Usage
 
 ```alloy
-discovery.gce "LABEL" {
-  project = PROJECT_NAME
-  zone    = ZONE_NAME
+discovery.gce "<LABEL>" {
+  project = <PROJECT_NAME>
+  zone    = <ZONE_NAME>
 }
 ```
 
@@ -37,11 +37,11 @@ The following arguments are supported:
 
 Name               | Type       | Description                                                                                                             | Default | Required
 -------------------|------------|-------------------------------------------------------------------------------------------------------------------------|---------|---------
-`project`          | `string`   | The GCP Project.                                                                                                        |         | yes
+`project`          | `string`   | The Google Cloud Platform Project.                                                                                                        |         | yes
 `zone`             | `string`   | The zone of the scrape targets.                                                                                         |         | yes
 `filter`           | `string`   | Filter can be used optionally to filter the instance list by other criteria.                                            |         | no
-`refresh_interval` | `duration` | Refresh interval to re-read the instance list.                                                                          | `"60s"` | no
 `port`             | `int`      | The port to scrape metrics from. If using the public IP address, this must instead be specified in the relabeling rule. | `80`    | no
+`refresh_interval` | `duration` | Refresh interval to re-read the instance list.                                                                          | `"60s"` | no
 `tag_separator`    | `string`   | The tag separator is used to separate the tags on concatenation.                                                        | `","`   | no
 
 For more information on the syntax of the `filter` argument, refer to Google's `filter` documentation for [Method: instances.list][].
@@ -58,20 +58,19 @@ Name      | Type                | Description
 
 Each target includes the following labels:
 
-* `__meta_gce_instance_id`: the numeric id of the instance
-* `__meta_gce_instance_name`: the name of the instance
-* `__meta_gce_label_LABEL_NAME`: each GCE label of the instance
-* `__meta_gce_machine_type`: full or partial URL of the machine type of the instance
-* `__meta_gce_metadata_NAME`: each metadata item of the instance
-* `__meta_gce_network`: the network URL of the instance
-* `__meta_gce_private_ip`: the private IP address of the instance
-* `__meta_gce_interface_ipv4_NAME`: IPv4 address of each named interface
-* `__meta_gce_project`: the GCP project in which the instance is running
-* `__meta_gce_public_ip`: the public IP address of the instance, if present
-* `__meta_gce_subnetwork`: the subnetwork URL of the instance
-* `__meta_gce_tags`: comma separated list of instance tags
-* `__meta_gce_zone`: the GCE zone URL in which the instance is running
-
+* `__meta_gce_instance_id`: The numeric ID of the instance.
+* `__meta_gce_instance_name`: The name of the instance.
+* `__meta_gce_interface_ipv4_NAME`: The IPv4 address of each named interface.
+* `__meta_gce_label_LABEL_NAME`: Each GCE label of the instance.
+* `__meta_gce_machine_type`: The full or partial URL of the machine type of the instance.
+* `__meta_gce_metadata_NAME`: Each metadata item of the instance.
+* `__meta_gce_network`: The network URL of the instance.
+* `__meta_gce_private_ip`: The private IP address of the instance.
+* `__meta_gce_project`: The GCP project in which the instance is running.
+* `__meta_gce_public_ip`: The public IP address of the instance, if present.
+* `__meta_gce_subnetwork`: The subnetwork URL of the instance.
+* `__meta_gce_tags`: A comma separated list of instance tags.
+* `__meta_gce_zone`: The GCE zone URL in which the instance is running.
 
 ## Component health
 
@@ -80,11 +79,11 @@ In those cases, exported fields retain their last healthy values.
 
 ## Debug information
 
-`discovery.gce` does not expose any component-specific debug information.
+`discovery.gce` doesn't expose any component-specific debug information.
 
 ## Debug metrics
 
-`discovery.gce` does not expose any component-specific debug metrics.
+`discovery.gce` doesn't expose any component-specific debug metrics.
 
 ## Example
 
@@ -101,19 +100,21 @@ prometheus.scrape "demo" {
 
 prometheus.remote_write "demo" {
   endpoint {
-    url = PROMETHEUS_REMOTE_WRITE_URL
+    url = <PROMETHEUS_REMOTE_WRITE_URL>
 
     basic_auth {
-      username = USERNAME
-      password = PASSWORD
+      username = <USERNAME>
+      password = <PASSWORD>
     }
   }
 }
 ```
+
 Replace the following:
-  - `PROMETHEUS_REMOTE_WRITE_URL`: The URL of the Prometheus remote_write-compatible server to send metrics to.
-  - `USERNAME`: The username to use for authentication to the remote_write API.
-  - `PASSWORD`: The password to use for authentication to the remote_write API.
+
+* _`<PROMETHEUS_REMOTE_WRITE_URL>`_: The URL of the Prometheus remote_write-compatible server to send metrics to.
+* _`<USERNAME>`_: The username to use for authentication to the `remote_write` API.
+* _`<PASSWORD>`_: The password to use for authentication to the `remote_write` API.
 
 <!-- START GENERATED COMPATIBLE COMPONENTS -->
 

From 8aa1d89084f2cbf1ca7ee598341a3427b2211fc6 Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Wed, 15 Jan 2025 16:06:25 -0800
Subject: [PATCH 5/6] Update Hetzner topic

---
 .../components/discovery/discovery.hetzner.md | 128 +++++++++---------
 1 file changed, 65 insertions(+), 63 deletions(-)

diff --git a/docs/sources/reference/components/discovery/discovery.hetzner.md b/docs/sources/reference/components/discovery/discovery.hetzner.md
index 0beeb7a79c..f17e252160 100644
--- a/docs/sources/reference/components/discovery/discovery.hetzner.md
+++ b/docs/sources/reference/components/discovery/discovery.hetzner.md
@@ -17,8 +17,8 @@ This service discovery uses the public IPv4 address by default, but that can be
 ## Usage
 
 ```alloy
-discovery.hetzner "LABEL" {
-  role = HETZNER_ROLE
+discovery.hetzner "<LABEL>" {
+  role = <HETZNER_ROLE>
 }
 ```
 
@@ -29,25 +29,26 @@ The following arguments are supported:
 Name                     | Type                | Description                                                                                      | Default | Required
 -------------------------|---------------------|--------------------------------------------------------------------------------------------------|---------|---------
 `role`                   | `string`            | Hetzner role of entities that should be discovered.                                              |         | yes
-`port`                   | `int`               | The port to scrape metrics from.                                                                 | `80`    | no
-`refresh_interval`       | `duration`          | The time after which the servers are refreshed.                                                  | `"60s"` | no
 `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
 `no_proxy`               | `string`            | Comma-separated list of IP addresses, CIDR notations, and domain names to exclude from proxying. |         | no
-`proxy_from_environment` | `bool`              | Use the proxy URL indicated by environment variables.                                            | `false` | no
+`port`                   | `int`               | The port to scrape metrics from.                                                                 | `80`    | no
 `proxy_connect_header`   | `map(list(secret))` | Specifies headers to send to proxies during CONNECT requests.                                    |         | no
+`proxy_from_environment` | `bool`              | Use the proxy URL indicated by environment variables.                                            | `false` | no
+`proxy_url`              | `string`            | HTTP proxy to send requests through.                                                             |         | no
+`refresh_interval`       | `duration`          | The time after which the servers are refreshed.                                                  | `"60s"` | no
 
 `role` must be one of `robot` or `hcloud`.
 
  At most, one of the following can be provided:
- - [`bearer_token` argument](#arguments).
- - [`bearer_token_file` argument](#arguments).
- - [`basic_auth` block][basic_auth].
- - [`authorization` block][authorization].
- - [`oauth2` block][oauth2].
+
+* [`authorization` block][authorization]
+* [`basic_auth` block][basic_auth]
+* [`bearer_token_file` argument][arguments]
+* [`bearer_token` argument][arguments]
+* [`oauth2` block][oauth2].
 
 [arguments]: #arguments
 
@@ -58,35 +59,35 @@ Name                     | Type                | Description
 The following blocks are supported inside the definition of
 `discovery.hetzner`:
 
-Hierarchy           | Block             | Description                                              | Required
---------------------|-------------------|----------------------------------------------------------|---------
-basic_auth          | [basic_auth][]    | Configure basic_auth for authenticating to the endpoint. | no
-authorization       | [authorization][] | Configure generic authorization to the endpoint.         | no
-oauth2              | [oauth2][]        | Configure OAuth2 for authenticating to the endpoint.     | no
-oauth2 > tls_config | [tls_config][]    | Configure TLS settings for connecting to the endpoint.   | no
-tls_config          | [tls_config][]    | Configure TLS settings for connecting to the endpoint.   | no
+Hierarchy           | Block             | Description                                                | Required
+--------------------|-------------------|------------------------------------------------------------|---------
+authorization       | [authorization][] | Configure generic authorization to the endpoint.           | no
+basic_auth          | [basic_auth][]    | Configure `basic_auth` for authenticating to the endpoint. | no
+oauth2              | [oauth2][]        | Configure OAuth2 for authenticating to the endpoint.       | no
+oauth2 > tls_config | [tls_config][]    | Configure TLS settings for connecting to the endpoint.     | no
+tls_config          | [tls_config][]    | Configure TLS settings for connecting to the endpoint.     | no
 
 The `>` symbol indicates deeper levels of nesting.
 For example, `oauth2 > tls_config` refers to a `tls_config` block defined inside an `oauth2` block.
 
-[basic_auth]: #basic_auth-block
-[authorization]: #authorization-block
-[oauth2]: #oauth2-block
-[tls_config]: #tls_config-block
+[authorization]: #authorization
+[basic_auth]: #basic_auth
+[oauth2]: #oauth2
+[tls_config]: #tls_config
 
-### basic_auth block
+### authorization
 
-{{< docs/shared lookup="reference/components/basic-auth-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
+{{< docs/shared lookup="reference/components/authorization-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### authorization block
+### basic_auth
 
-{{< docs/shared lookup="reference/components/authorization-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
+{{< docs/shared lookup="reference/components/basic-auth-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### oauth2 block
+### oauth2
 
 {{< docs/shared lookup="reference/components/oauth2-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### tls_config block
+### tls_config
 
 {{< docs/shared lookup="reference/components/tls-config-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
@@ -100,53 +101,52 @@ Name      | Type                | Description
 
 Each target includes the following labels:
 
-* `__meta_hetzner_server_id`: the ID of the server
-* `__meta_hetzner_server_name`: the name of the server
-* `__meta_hetzner_server_status`: the status of the server
-* `__meta_hetzner_public_ipv4`: the public ipv4 address of the server
-* `__meta_hetzner_public_ipv6_network`: the public ipv6 network (/64) of the server
-* `__meta_hetzner_datacenter`: the datacenter of the server
+* `__meta_hetzner_datacenter`: The data center of the server
+* `__meta_hetzner_public_ipv4`: The public IPv4 address of the server.
+* `__meta_hetzner_public_ipv6_network`: The public IPv6 network (/64) of the server.
+* `__meta_hetzner_server_id`: The ID of the server.
+* `__meta_hetzner_server_name`: The name of the server.
+* `__meta_hetzner_server_status`: The status of the server.
 
 ### `hcloud`
 
 The labels below are only available for targets with `role` set to `hcloud`:
 
-* `__meta_hetzner_hcloud_image_name`: the image name of the server
-* `__meta_hetzner_hcloud_image_description`: the description of the server image
-* `__meta_hetzner_hcloud_image_os_flavor`: the OS flavor of the server image
-* `__meta_hetzner_hcloud_image_os_version`: the OS version of the server image
-* `__meta_hetzner_hcloud_datacenter_location`: the location of the server
-* `__meta_hetzner_hcloud_datacenter_location_network_zone`: the network zone of the server
-* `__meta_hetzner_hcloud_server_type`: the type of the server
-* `__meta_hetzner_hcloud_cpu_cores`: the CPU cores count of the server
-* `__meta_hetzner_hcloud_cpu_type`: the CPU type of the server (shared or dedicated)
-* `__meta_hetzner_hcloud_memory_size_gb`: the amount of memory of the server (in GB)
-* `__meta_hetzner_hcloud_disk_size_gb`: the disk size of the server (in GB)
-* `__meta_hetzner_hcloud_private_ipv4_<networkname>`: the private ipv4 address of the server within a given network
-* `__meta_hetzner_hcloud_label_<labelname>`: each label of the server
-* `__meta_hetzner_hcloud_labelpresent_<labelname>`: `true` for each label of the server
+* `__meta_hetzner_hcloud_cpu_cores`: The CPU cores count of the server.
+* `__meta_hetzner_hcloud_cpu_type`: The CPU type of the server (shared or dedicated).
+* `__meta_hetzner_hcloud_datacenter_location_network_zone`: The network zone of the server.
+* `__meta_hetzner_hcloud_datacenter_location`: The location of the server.
+* `__meta_hetzner_hcloud_disk_size_gb`: The disk size of the server (in GB).
+* `__meta_hetzner_hcloud_image_description`: The description of the server image.
+* `__meta_hetzner_hcloud_image_name`: The image name of the server.
+* `__meta_hetzner_hcloud_image_os_flavor`: The OS flavor of the server image.
+* `__meta_hetzner_hcloud_image_os_version`: The OS version of the server image.
+* `__meta_hetzner_hcloud_label_<labelname>`: Each label of the server.
+* `__meta_hetzner_hcloud_labelpresent_<labelname>`: `true` for each label of the server.
+* `__meta_hetzner_hcloud_memory_size_gb`: The amount of memory of the server (in GB).
+* `__meta_hetzner_hcloud_private_ipv4_<networkname>`: The private IPv4 address of the server within a given network.
+* `__meta_hetzner_hcloud_server_type`: The type of the server.
 
 ### `robot`
 
 The labels below are only available for targets with `role` set to `robot`:
 
-* `__meta_hetzner_robot_product`: the product of the server
-* `__meta_hetzner_robot_cancelled`: the server cancellation status
+* `__meta_hetzner_robot_cancelled`: The server cancellation status.
+* `__meta_hetzner_robot_product`: The product of the server.
 
 
 ## Component health
 
-`discovery.hetzner` is only reported as unhealthy when given an invalid
-configuration. In those cases, exported fields retain their last healthy
-values.
+`discovery.hetzner` is only reported as unhealthy when given an invalid configuration.
+In those cases, exported fields retain their last healthy values.
 
 ## Debug information
 
-`discovery.hetzner` does not expose any component-specific debug information.
+`discovery.hetzner` doesn't expose any component-specific debug information.
 
 ## Debug metrics
 
-`discovery.hetzner` does not expose any component-specific debug metrics.
+`discovery.hetzner` doesn't expose any component-specific debug metrics.
 
 ## Example
 
@@ -154,7 +154,7 @@ This example discovers targets from Hetzner:
 
 ```alloy
 discovery.hetzner "example" {
-  role = HETZNER_ROLE
+  role = <HETZNER_ROLE>
 }
 
 prometheus.scrape "demo" {
@@ -164,20 +164,22 @@ prometheus.scrape "demo" {
 
 prometheus.remote_write "demo" {
   endpoint {
-    url = PROMETHEUS_REMOTE_WRITE_URL
+    url = <PROMETHEUS_REMOTE_WRITE_URL>
 
     basic_auth {
-      username = USERNAME
-      password = PASSWORD
+      username = <USERNAME>
+      password = <PASSWORD>
     }
   }
 }
 ```
+
 Replace the following:
-  - `HETZNER_ROLE`: The role of the entities that should be discovered.
-  - `PROMETHEUS_REMOTE_WRITE_URL`: The URL of the Prometheus remote_write-compatible server to send metrics to.
-  - `USERNAME`: The username to use for authentication to the remote_write API.
-  - `PASSWORD`: The password to use for authentication to the remote_write API.
+
+* _`<HETZNER_ROLE>`_: The role of the entities that should be discovered.
+* _`<PROMETHEUS_REMOTE_WRITE_URL>`_: The URL of the Prometheus remote_write-compatible server to send metrics to.
+* _`<USERNAME>`_: The username to use for authentication to the `remote_write` API.
+* _`<PASSWORD>`_: The password to use for authentication to the `remote_write` API.
 
 <!-- START GENERATED COMPATIBLE COMPONENTS -->
 

From af91b84b7e4a6fe9aa40abbe2d51069b66fc3bf7 Mon Sep 17 00:00:00 2001
From: Clayton Cornell <clayton.cornell@grafana.com>
Date: Wed, 15 Jan 2025 16:16:29 -0800
Subject: [PATCH 6/6] Update HTTP and Ionos topics

---
 .../components/discovery/discovery.http.md    |  58 ++++-----
 .../components/discovery/discovery.ionos.md   | 113 +++++++++---------
 2 files changed, 85 insertions(+), 86 deletions(-)

diff --git a/docs/sources/reference/components/discovery/discovery.http.md b/docs/sources/reference/components/discovery/discovery.http.md
index 460684ab8c..4f8e19c968 100644
--- a/docs/sources/reference/components/discovery/discovery.http.md
+++ b/docs/sources/reference/components/discovery/discovery.http.md
@@ -28,11 +28,11 @@ Example response body:
 ]
 ```
 
-It is possible to use additional fields in the JSON to pass parameters to [prometheus.scrape][] such as the `metricsPath` and `scrape_interval`.
+It is possible to use additional fields in the JSON to pass parameters to [`prometheus.scrape`][prometheus.scrape] such as the `metricsPath` and `scrape_interval`.
 
 [prometheus.scrape]: ../../prometheus/prometheus.scrape/#technical-details
 
-As an example, the following will provide a target with a custom `metricsPath`, scrape interval, and timeout value:
+The following example provides a target with a custom `metricsPath`, scrape interval, and timeout value:
 
 ```json
 [
@@ -54,7 +54,7 @@ As an example, the following will provide a target with a custom `metricsPath`,
 
 It's also possible to append query parameters to the metrics path with the `__param_<name>` syntax.
 
-For example, the following will call a metrics path of `/health?target_data=prometheus`:
+The following example calls the metrics path `/health?target_data=prometheus`:
 
 ```json
 [
@@ -75,15 +75,15 @@ For example, the following will call a metrics path of `/health?target_data=prom
 
 ```
 
-For more information on the potential labels you can use, see the [prometheus.scrape technical details][prometheus.scrape] section, or the [Prometheus Configuration][] documentation.
+For more information on the potential labels you can use, refer to the [`prometheus.scrape` technical details][prometheus.scrape] section, or the [Prometheus Configuration][] documentation.
 
 [Prometheus Configuration]: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
 
 ## Usage
 
 ```alloy
-discovery.http "LABEL" {
-  url = URL
+discovery.http "<LABEL>" {
+  url = <URL>
 }
 ```
 
@@ -94,22 +94,23 @@ The following arguments are supported:
 Name                     | Type                | Description                                                                                      | Default | Required
 -------------------------|---------------------|--------------------------------------------------------------------------------------------------|---------|---------
 `url`                    | `string`            | URL to scrape.                                                                                   |         | yes
-`refresh_interval`       | `duration`          | How often to refresh targets.                                                                    | `"60s"` | no
 `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
 `no_proxy`               | `string`            | Comma-separated list of IP addresses, CIDR notations, and domain names to exclude from proxying. |         | no
-`proxy_from_environment` | `bool`              | Use the proxy URL indicated by environment variables.                                            | `false` | no
 `proxy_connect_header`   | `map(list(secret))` | Specifies headers to send to proxies during CONNECT requests.                                    |         | no
+`proxy_from_environment` | `bool`              | Use the proxy URL indicated by environment variables.                                            | `false` | no
+`proxy_url`              | `string`            | HTTP proxy to send requests through.                                                             |         | no
+`refresh_interval`       | `duration`          | How often to refresh targets.                                                                    | `"60s"` | no
 
  At most, one of the following can be provided:
- - [`bearer_token` argument](#arguments).
- - [`bearer_token_file` argument](#arguments).
- - [`basic_auth` block][basic_auth].
- - [`authorization` block][authorization].
- - [`oauth2` block][oauth2].
+
+* [`bearer_token` argument][arguments]
+* [`bearer_token_file` argument][arguments]
+* [`basic_auth` block][basic_auth]
+* [`authorization` block][authorization]
+* [`oauth2` block][oauth2]
 
 [arguments]: #arguments
 
@@ -117,13 +118,12 @@ Name                     | Type                | Description
 
 ## Blocks
 
-The following blocks are supported inside the definition of
-`discovery.http`:
+The following blocks are supported inside the definition of `discovery.http`:
 
 Hierarchy           | Block             | Description                                              | Required
 --------------------|-------------------|----------------------------------------------------------|---------
-basic_auth          | [basic_auth][]    | Configure basic_auth for authenticating to the endpoint. | no
 authorization       | [authorization][] | Configure generic authorization to the endpoint.         | no
+basic_auth          | [basic_auth][]    | Configure basic_auth for authenticating to the endpoint. | no
 oauth2              | [oauth2][]        | Configure OAuth2 for authenticating to the endpoint.     | no
 oauth2 > tls_config | [tls_config][]    | Configure TLS settings for connecting to the endpoint.   | no
 tls_config          | [tls_config][]    | Configure TLS settings for connecting to the endpoint.   | no
@@ -131,24 +131,24 @@ tls_config          | [tls_config][]    | Configure TLS settings for connecting
 The `>` symbol indicates deeper levels of nesting.
 For example, `oauth2 > tls_config` refers to a `tls_config` block defined inside an `oauth2` block.
 
-[basic_auth]: #basic_auth-block
-[authorization]: #authorization-block
-[oauth2]: #oauth2-block
-[tls_config]: #tls_config-block
+[authorization]: #authorization
+[basic_auth]: #basic_auth
+[oauth2]: #oauth2
+[tls_config]: #tls_config
 
-### basic_auth block
+### authorization
 
-{{< docs/shared lookup="reference/components/basic-auth-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
+{{< docs/shared lookup="reference/components/authorization-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### authorization block
+### basic_auth
 
-{{< docs/shared lookup="reference/components/authorization-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
+{{< docs/shared lookup="reference/components/basic-auth-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### oauth2 block
+### oauth2
 
 {{< docs/shared lookup="reference/components/oauth2-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### tls_config block
+### tls_config
 
 {{< docs/shared lookup="reference/components/tls-config-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
@@ -171,7 +171,7 @@ In those cases, exported fields retain their last healthy values.
 
 ## Debug information
 
-`discovery.http` does not expose any component-specific debug information.
+`discovery.http` doesn't expose any component-specific debug information.
 
 ## Debug metrics
 
@@ -179,7 +179,7 @@ In those cases, exported fields retain their last healthy values.
 
 ## Examples
 
-This example will query a URL every 15 seconds and expose targets that it finds:
+This example queries a URL every 15 seconds and exposes the targets that it finds:
 
 ```alloy
 discovery.http "dynamic_targets" {
diff --git a/docs/sources/reference/components/discovery/discovery.ionos.md b/docs/sources/reference/components/discovery/discovery.ionos.md
index d6760df721..c213e5f24f 100644
--- a/docs/sources/reference/components/discovery/discovery.ionos.md
+++ b/docs/sources/reference/components/discovery/discovery.ionos.md
@@ -15,8 +15,8 @@ title: discovery.ionos
 ## Usage
 
 ```alloy
-discovery.ionos "LABEL" {
-    datacenter_id = DATACENTER_ID
+discovery.ionos "<LABEL>" {
+    datacenter_id = <DATACENTER_ID>
 }
 ```
 
@@ -27,23 +27,24 @@ The following arguments are supported:
 Name                     | Type                | Description                                                                                      | Default | Required
 -------------------------|---------------------|--------------------------------------------------------------------------------------------------|---------|---------
 `datacenter_id`          | `string`            | The unique ID of the data center.                                                                |         | yes
-`refresh_interval`       | `duration`          | The time after which the servers are refreshed.                                                  | `60s`   | no
-`port`                   | `int`               | The port to scrape metrics from.                                                                 | 80      | no
 `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
 `no_proxy`               | `string`            | Comma-separated list of IP addresses, CIDR notations, and domain names to exclude from proxying. |         | no
-`proxy_from_environment` | `bool`              | Use the proxy URL indicated by environment variables.                                            | `false` | no
+`port`                   | `int`               | The port to scrape metrics from.                                                                 | 80      | no
 `proxy_connect_header`   | `map(list(secret))` | Specifies headers to send to proxies during CONNECT requests.                                    |         | no
+`proxy_from_environment` | `bool`              | Use the proxy URL indicated by environment variables.                                            | `false` | no
+`proxy_url`              | `string`            | HTTP proxy to send requests through.                                                             |         | no
+`refresh_interval`       | `duration`          | The time after which the servers are refreshed.                                                  | `60s`   | no
 
  At most, one of the following can be provided:
- - [`bearer_token` argument](#arguments).
- - [`bearer_token_file` argument](#arguments).
- - [`basic_auth` block][basic_auth].
- - [`authorization` block][authorization].
- - [`oauth2` block][oauth2].
+
+* [`authorization` block][authorization]
+* [`basic_auth` block][basic_auth]
+* [`bearer_token_file` argument][arguments]
+* [`bearer_token` argument][arguments]
+* [`oauth2` block][oauth2]
 
 [arguments]: #arguments
 
@@ -51,39 +52,37 @@ Name                     | Type                | Description
 
 ## Blocks
 
-The following blocks are supported inside the definition of
-`discovery.ionos`:
+The following blocks are supported inside the definition of `discovery.ionos`:
 
-| Hierarchy           | Block             | Description                                              | Required |
-| ------------------- | ----------------- | -------------------------------------------------------- | -------- |
-| basic_auth          | [basic_auth][]    | Configure basic_auth for authenticating to the endpoint. | no       |
-| authorization       | [authorization][] | Configure generic authorization to the endpoint.         | no       |
-| oauth2              | [oauth2][]        | Configure OAuth2 for authenticating to the endpoint.     | no       |
-| oauth2 > tls_config | [tls_config][]    | Configure TLS settings for connecting to the endpoint.   | no       |
-| tls_config          | [tls_config][]    | Configure TLS settings for connecting to the endpoint.   | no       |
+Hierarchy           | Block             | Description                                                | Required
+--------------------|-------------------|------------------------------------------------------------|---------
+authorization       | [authorization][] | Configure generic authorization to the endpoint.           | no
+basic_auth          | [basic_auth][]    | Configure `basic_auth` for authenticating to the endpoint. | no
+oauth2              | [oauth2][]        | Configure OAuth2 for authenticating to the endpoint.       | no
+oauth2 > tls_config | [tls_config][]    | Configure TLS settings for connecting to the endpoint.     | no
+tls_config          | [tls_config][]    | Configure TLS settings for connecting to the endpoint.     | no
 
-The `>` symbol indicates deeper levels of nesting. For example,
-`oauth2 > tls_config` refers to a `tls_config` block defined inside
-an `oauth2` block.
+The `>` symbol indicates deeper levels of nesting.
+For example, `oauth2 > tls_config` refers to a `tls_config` block defined inside an `oauth2` block.
 
-[basic_auth]: #basic_auth-block
-[authorization]: #authorization-block
-[oauth2]: #oauth2-block
-[tls_config]: #tls_config-block
+[authorization]: #authorization
+[basic_auth]: #basic_auth
+[oauth2]: #oauth2
+[tls_config]: #tls_config
 
-### basic_auth block
+### authorization
 
-{{< docs/shared lookup="reference/components/basic-auth-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
+{{< docs/shared lookup="reference/components/authorization-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### authorization block
+### basic_auth
 
-{{< docs/shared lookup="reference/components/authorization-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
+{{< docs/shared lookup="reference/components/basic-auth-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### oauth2 block
+### oauth2
 
 {{< docs/shared lookup="reference/components/oauth2-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
-### tls_config block
+### tls_config
 
 {{< docs/shared lookup="reference/components/tls-config-block.md" source="alloy" version="<ALLOY_VERSION>" >}}
 
@@ -91,25 +90,25 @@ an `oauth2` block.
 
 The following fields are exported and can be referenced by other components:
 
-| Name      | Type                | Description                                             |
-| --------- | ------------------- | ------------------------------------------------------- |
-| `targets` | `list(map(string))` | The set of targets discovered from the IONOS Cloud API. |
+Name      | Type                | Description
+----------|---------------------|--------------------------------------------------------
+`targets` | `list(map(string))` | The set of targets discovered from the IONOS Cloud API.
 
 Each target includes the following labels:
 
-- `__meta_ionos_server_availability_zone`: the availability zone of the server.
-- `__meta_ionos_server_boot_cdrom_id`: the ID of the CD-ROM the server is booted from.
-- `__meta_ionos_server_boot_image_id`: the ID of the boot image or snapshot the server is booted from.
-- `__meta_ionos_server_boot_volume_id`: the ID of the boot volume.
-- `__meta_ionos_server_cpu_family`: the CPU family of the server to.
-- `__meta_ionos_server_id`: the ID of the server.
-- `__meta_ionos_server_ip`: comma separated list of all IPs assigned to the server.
-- `__meta_ionos_server_lifecycle`: the lifecycle state of the server resource.
-- `__meta_ionos_server_name`: the name of the server.
-- `__meta_ionos_server_nic_ip_<nic_name>`: comma separated list of IPs, grouped by the name of each NIC attached to the server.
-- `__meta_ionos_server_servers_id`: the ID of the servers the server belongs to.
-- `__meta_ionos_server_state`: the execution state of the server.
-- `__meta_ionos_server_type`: the type of the server.
+* `__meta_ionos_server_availability_zone`: The availability zone of the server.
+* `__meta_ionos_server_boot_cdrom_id`: The ID of the CD-ROM the server is booted from.
+* `__meta_ionos_server_boot_image_id`: The ID of the boot image or snapshot the server is booted from.
+* `__meta_ionos_server_boot_volume_id`: The ID of the boot volume.
+* `__meta_ionos_server_cpu_family`: The CPU family of the server to.
+* `__meta_ionos_server_id`: The ID of the server.
+* `__meta_ionos_server_ip`: A comma separated list of all IPs assigned to the server.
+* `__meta_ionos_server_lifecycle`: The lifecycle state of the server resource.
+* `__meta_ionos_server_name`: The name of the server.
+* `__meta_ionos_server_nic_ip_<nic_name>`: A comma separated list of IPs, grouped by the name of each NIC attached to the server.
+* `__meta_ionos_server_servers_id`: The ID of the servers the server belongs to.
+* `__meta_ionos_server_state`: The execution state of the server.
+* `__meta_ionos_server_type`: The type of the server.
 
 ## Component health
 
@@ -118,11 +117,11 @@ In those cases, exported fields retain their last healthy values.
 
 ## Debug information
 
-`discovery.ionos` does not expose any component-specific debug information.
+`discovery.ionos` doesn't expose any component-specific debug information.
 
 ## Debug metrics
 
-`discovery.ionos` does not expose any component-specific debug metrics.
+`discovery.ionos` doesn't expose any component-specific debug metrics.
 
 ## Example
 
@@ -138,11 +137,11 @@ prometheus.scrape "demo" {
 
 prometheus.remote_write "demo" {
   endpoint {
-    url = PROMETHEUS_REMOTE_WRITE_URL
+    url = <PROMETHEUS_REMOTE_WRITE_URL>
 
     basic_auth {
-      username = USERNAME
-      password = PASSWORD
+      username = <USERNAME>
+      password = <PASSWORD>
     }
   }
 }
@@ -150,9 +149,9 @@ prometheus.remote_write "demo" {
 
 Replace the following:
 
-- `PROMETHEUS_REMOTE_WRITE_URL`: The URL of the Prometheus remote_write-compatible server to send metrics to.
-- `USERNAME`: The username to use for authentication to the remote_write API.
-- `PASSWORD`: The password to use for authentication to the remote_write API.
+* _`<PROMETHEUS_REMOTE_WRITE_URL>`_: The URL of the Prometheus remote_write-compatible server to send metrics to.
+* _`<USERNAME>`_: The username to use for authentication to the `remote_write` API.
+* _`<PASSWORD>`_: The password to use for authentication to the `remote_write` API.
 
 <!-- START GENERATED COMPATIBLE COMPONENTS -->