feedback, thanks

docs/README.md

@@ -23,11 +23,11 @@ If the check fails, then the doc supported services list should be updated. For
 
 ## Update generated reference docs
 
-Some sections of Agent Flow reference documentation are automatically generated. To update them, run `make generate-docs`.
+Some sections of Grafana Agent Flow reference documentation are automatically generated. To update them, run `make generate-docs`.
 
 ### Community Projects
 
-Below is a list of community-led projects for working with Grafana Agent. These projects are not maintained or supported by Grafana Labs.
+The following is a list of community-led projects for working with Grafana Agent. These projects are not maintained or supported by Grafana Labs.
 
 #### Helm (Kubernetes Deployment)
 

docs/generator/links_to_types.go

@@ -37,9 +37,14 @@ func (l *LinksToTypesGenerator) Generate() (string, error) {
 		return "", nil
 	}
 
-	note := "\nNote that connecting some components may not be feasible or components may require further " +
-		"configuration to make the connection work correctly. " +
-		"Please refer to the linked documentation for more details.\n\n"
+	note := `
+{{% admonition type="note" %}}
+
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
+`
 
 	return heading + acceptingSection + outputSection + note, nil
 }

docs/sources/flow/reference/compatibility/_index.md

@@ -32,16 +32,15 @@ that can export or consume it.
 
 ## Targets
 
-Targets are a `list(map(string))` - a [list]({{< relref "../../config-language/expressions/types_and_values/#naming-convention" >}}) of [maps]({{< relref "../../config-language/expressions/types_and_values/#naming-convention" >}}) with [string]({{< relref "../../config-language/expressions/types_and_values/#strings" >}}) values. As such,
-they can contain different key-value pairs and can be used with a wide range of
-components. Some components require Targets to contain specific key-value pairs in order
-to work correctly, it is recommended to always check component reference for
+Targets are a `list(map(string))` - a [list]({{< relref "../../config-language/expressions/types_and_values/#naming-convention" >}}) of [maps]({{< relref "../../config-language/expressions/types_and_values/#naming-convention" >}}) with [string]({{< relref "../../config-language/expressions/types_and_values/#strings" >}}) values.
+They can contain different key-value pairs, and you can use them with a wide range of
+components. Some components require Targets to contain specific key-value pairs
+to work correctly. It is recommended to always check component references for
 details when working with Targets.
 
 <!-- NOTE: this title is used as an anchor in links. Do not change. -->
 ### Targets Exporters
-Below are components that _export_ Targets grouped by namespace. Click
-on the namespace to expand and see more detail.
+The following components, grouped by namespace, _export_ Targets.
 
 <!-- START GENERATED SECTION: EXPORTERS OF Targets -->
 
@@ -116,8 +115,7 @@ on the namespace to expand and see more detail.
 
 <!-- NOTE: this title is used as an anchor in links. Do not change. -->
 ### Targets Consumers
-Below are components that _consume_ Targets grouped by namespace. Click
-on the namespace to expand and see more detail.
+The following components, grouped by namespace, _consume_ Targets.
 
 <!-- START GENERATED SECTION: CONSUMERS OF Targets -->
 
@@ -161,8 +159,7 @@ following components to build your Prometheus metrics pipeline:
 
 <!-- NOTE: this title is used as an anchor in links. Do not change. -->
 ### Prometheus `MetricsReceiver` Exporters
-Below are components that _export_ Prometheus `MetricsReceiver`, grouped by namespace. Click
-on the namespace to expand and see more detail.
+The following components, grouped by namespace, _export_ Prometheus `MetricsReceiver`.
 
 <!-- START GENERATED SECTION: EXPORTERS OF Prometheus `MetricsReceiver` -->
 
@@ -179,8 +176,8 @@ on the namespace to expand and see more detail.
 
 <!-- NOTE: this title is used as an anchor in links. Do not change. -->
 ### Prometheus `MetricsReceiver` Consumers
-Below are components that _consume_ Prometheus `MetricsReceiver`, grouped by namespace. Click
-on the namespace to expand and see more detail.
+The following components, grouped by namespace, _consume_ Prometheus `MetricsReceiver`.
+ 
 
 <!-- START GENERATED SECTION: CONSUMERS OF Prometheus `MetricsReceiver` -->
 
@@ -210,8 +207,7 @@ following components to build your Loki logs pipeline:
 
 <!-- NOTE: this title is used as an anchor in links. Do not change. -->
 ### Loki `LogsReceiver` Exporters
-Below are components that _export_ Loki `LogsReceiver` grouped by namespace. Click
-on the namespace to expand and see more detail.
+The following components, grouped by namespace, _export_ Loki `LogsReceiver`.
 
 <!-- START GENERATED SECTION: EXPORTERS OF Loki `LogsReceiver` -->
 
@@ -230,8 +226,7 @@ on the namespace to expand and see more detail.
 
 <!-- NOTE: this title is used as an anchor in links. Do not change. -->
 ### Loki `LogsReceiver` Consumers
-Below are components that _consume_ Loki `LogsReceiver` grouped by namespace. Click
-on the namespace to expand and see more detail.
+The following components, grouped by namespace, _consume_ Loki `LogsReceiver`.
 
 <!-- START GENERATED SECTION: CONSUMERS OF Loki `LogsReceiver` -->
 
@@ -273,13 +268,12 @@ The OpenTelemetry data is sent between components using `otelcol.Consumer`s.
 `otelcol.Consumer`s are [capsules]({{< relref "../../config-language/expressions/types_and_values/#capsules" >}})
 that are exported by components that can receive OpenTelemetry data. Components that
 can consume OpenTelemetry data can be passed the `otelcol.Consumer` as an argument. Note that some components
-that use `otelcol.Consumer` only support a subset of telemetry signals, e.g. only traces. Check the component
+that use `otelcol.Consumer` only support a subset of telemetry signals, for example, only traces. Check the component
 reference pages for more details on what is supported. Use the following components to build your OpenTelemetry pipeline:
 
 <!-- NOTE: this title is used as an anchor in links. Do not change. -->
 ### OpenTelemetry `otelcol.Consumer` Exporters
-Below are components that _export_ OpenTelemetry `otelcol.Consumer`, grouped by namespace. Click
-on the namespace to expand and see more detail.
+The following components, grouped by namespace, _export_ OpenTelemetry `otelcol.Consumer`.
 
 <!-- START GENERATED SECTION: EXPORTERS OF OpenTelemetry `otelcol.Consumer` -->
 
@@ -309,8 +303,7 @@ on the namespace to expand and see more detail.
 
 <!-- NOTE: this title is used as an anchor in links. Do not change. -->
 ### OpenTelemetry `otelcol.Consumer` Consumers
-Below are components that _consume_ OpenTelemetry `otelcol.Consumer`, grouped by namespace. Click
-on the namespace to expand and see more detail.
+The following components, grouped by namespace, _consume_ OpenTelemetry `otelcol.Consumer`.
 
 <!-- START GENERATED SECTION: CONSUMERS OF OpenTelemetry `otelcol.Consumer` -->
 
@@ -356,8 +349,7 @@ following components to build your Pyroscope profiles pipeline:
 
 <!-- NOTE: this title is used as an anchor in links. Do not change. -->
 ### Pyroscope `ProfilesReceiver` Exporters
-Below are components that _export_ Pyroscope `ProfilesReceiver`, grouped by namespace. Click
-on the namespace to expand and see more detail.
+The following components, grouped by namespace, _export_ Pyroscope `ProfilesReceiver`.
 
 <!-- START GENERATED SECTION: EXPORTERS OF Pyroscope `ProfilesReceiver` -->
 
@@ -369,8 +361,7 @@ on the namespace to expand and see more detail.
 
 <!-- NOTE: this title is used as an anchor in links. Do not change. -->
 ### Pyroscope `ProfilesReceiver` Consumers
-Below are components that _consume_ Pyroscope `ProfilesReceiver`, grouped by namespace. Click
-on the namespace to expand and see more detail.
+The following components, grouped by namespace, _consume_ Pyroscope `ProfilesReceiver`.
 
 <!-- START GENERATED SECTION: CONSUMERS OF Pyroscope `ProfilesReceiver` -->
 

docs/sources/flow/reference/components/discovery.azure.md

@@ -158,7 +158,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.consul.md

@@ -176,7 +176,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.consulagent.md

@@ -138,7 +138,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.digitalocean.md

@@ -129,7 +129,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.dns.md

@@ -103,7 +103,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.docker.md

@@ -224,7 +224,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.dockerswarm.md

@@ -247,7 +247,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.ec2.md

@@ -143,7 +143,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.eureka.md

@@ -149,7 +149,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.file.md

@@ -182,7 +182,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.gce.md

@@ -122,7 +122,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.hetzner.md

@@ -185,7 +185,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.http.md

@@ -177,7 +177,11 @@ discovery.http "dynamic_targets" {
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.ionos.md

@@ -149,7 +149,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.kubelet.md

@@ -202,7 +202,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.kubernetes.md

@@ -502,7 +502,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.kuma.md

@@ -144,7 +144,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.lightsail.md

@@ -108,7 +108,11 @@ Replace the following:
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
 
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
+
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->

docs/sources/flow/reference/components/discovery.linode.md

@@ -184,7 +184,11 @@ prometheus.remote_write "demo" {
 
 - Components that consume [Targets]({{< relref "../compatibility/#targets-consumers" >}})
 
-Note that connecting some components may not be feasible or components may require further configuration to make the connection work correctly. Please refer to the linked documentation for more details.
+{{% admonition type="note" %}}
+
+Connecting some components may not be sensible or components may require further configuration to make the 
+connection work correctly. Refer to the linked documentation for more details.
 
+{{% /admonition %}}
 
 <!-- END GENERATED COMPATIBLE COMPONENTS -->