create migrate tasks subdirectory (#6051)

docs/sources/about.md

@@ -33,8 +33,8 @@ Grafana Agent is available in three different variants:
 [Prometheus]: "/docs/grafana-cloud/ -> /docs/agent/<AGENT_VERSION>/flow/tasks/collect-prometheus-metrics.md"
 [OTel]: "/docs/agent/ -> /docs/agent/<AGENT_VERSION>/flow/tasks/collect-opentelemetry-data.md"
 [OTel]: "/docs/grafana-cloud/ -> /docs/agent/<AGENT_VERSION>/flow/tasks/collect-opentelemetry-data.md"
-[Loki]: "/docs/agent/ -> /docs/agent/<AGENT_VERSION>/flow/tasks/migrating-from-promtail.md"
-[Loki]: "/docs/grafana-cloud/ -> /docs/agent/<AGENT_VERSION>/flow/tasks/migrating-from-promtail.md"
+[Loki]: "/docs/agent/ -> /docs/agent/<AGENT_VERSION>/flow/tasks/migrate/from-promtail.md"
+[Loki]: "/docs/grafana-cloud/ -> /docs/agent/<AGENT_VERSION>/flow/tasks/migrate/from-promtail.md"
 [clustering]: "/docs/agent/ -> /docs/agent/<AGENT_VERSION>/flow/concepts/clustering/_index.md"
 [clustering]: "/docs/grafana-cloud/ -> /docs/agent/<AGENT_VERSION>/flow/concepts/clustering/_index.md"
 [rules]: "/docs/agent/ -> /docs/agent/latest/flow/reference/components/mimir.rules.kubernetes.md"

docs/sources/flow/reference/cli/convert.md

@@ -82,7 +82,7 @@ This includes Prometheus features such as
 and many supported *_sd_configs. Unsupported features in a source configuration result
 in [errors].
 
-Refer to [Migrate from Prometheus to {{< param "PRODUCT_NAME" >}}]({{< relref "../../tasks/migrating-from-prometheus/" >}}) for a detailed migration guide.
+Refer to [Migrate from Prometheus to {{< param "PRODUCT_NAME" >}}]({{< relref "../../tasks/migrate/from-prometheus/" >}}) for a detailed migration guide.
 
 ### Promtail
 
@@ -96,7 +96,7 @@ are supported and can be converted to {{< param "PRODUCT_NAME" >}} configuration
 If you have unsupported features in a source configuration, you will receive [errors] when you convert to a flow configuration. The converter will
 also raise warnings for configuration options that may require your attention.
 
-Refer to [Migrate from Promtail to {{< param "PRODUCT_NAME" >}}]({{< relref "../../tasks/migrating-from-promtail/" >}}) for a detailed migration guide.
+Refer to [Migrate from Promtail to {{< param "PRODUCT_NAME" >}}]({{< relref "../../tasks/migrate/from-promtail/" >}}) for a detailed migration guide.
 
 ### Static
 
@@ -113,4 +113,4 @@ flags with a space between each flag, for example `--extra-args="-enable-feature
 If you have unsupported features in a Static mode source configuration, you will receive [errors][] when you convert to a Flow mode configuration. The converter will
 also raise warnings for configuration options that may require your attention.
 
-Refer to [Migrate from Grafana Agent Static to {{< param "PRODUCT_NAME" >}}]({{< relref "../../tasks/migrating-from-static/" >}}) for a detailed migration guide.
+Refer to [Migrate from Grafana Agent Static to {{< param "PRODUCT_NAME" >}}]({{< relref "../../tasks/migrate/from-static/" >}}) for a detailed migration guide.

docs/sources/flow/tasks/migrate/_index.md

@@ -0,0 +1,19 @@
+---
+aliases:
+- /docs/grafana-cloud/agent/flow/tasks/migrate/
+- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrate/
+- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrate/
+- /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/
+canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrate/
+description: How to migrate to Grafana Agent Flow
+menuTitle: Migrate
+title: Migrate to Grafana Agent Flow
+weight: 100
+---
+
+# How to migrate to {{% param "PRODUCT_NAME" %}}
+
+This section details how to migrate to {{< param "PRODUCT_NAME" >}} from other
+common solutions.
+
+{{< section >}}

docs/sources/flow/tasks/migrating-from-operator.md → docs/sources/flow/tasks/migrate/from-operator.md

@@ -1,19 +1,19 @@
 ---
 aliases:
-- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrating-from-operator/
-- /docs/grafana-cloud/send-data/agent/flow/tasks/migrating-from-operator/
+- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrate/from-operator/
+- /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/from-operator/
 # Previous page aliases for backwards compatibility:
 - /docs/grafana-cloud/monitor-infrastructure/agent/flow/getting-started/migrating-from-operator/
 - /docs/grafana-cloud/send-data/agent/flow/getting-started/migrating-from-operator/
 - ../getting-started/migrating-from-operator/ # /docs/agent/latest/flow/getting-started/migrating-from-operator/
-canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrating-from-operator/
-description: Migrating from Grafana Agent Operator to Grafana Agent Flow
+canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrate/from-operator/
+description: Migrate from Grafana Agent Operator to Grafana Agent Flow
 menuTitle: Migrate from Operator
-title: Migrating from Grafana Agent Operator to Grafana Agent Flow
+title: Migrate from Grafana Agent Operator to Grafana Agent Flow
 weight: 320
 ---
 
-# Migrating from Grafana Agent Operator to {{% param "PRODUCT_NAME" %}}
+# Migrate from Grafana Agent Operator to {{% param "PRODUCT_NAME" %}}
 
 With the release of {{< param "PRODUCT_NAME" >}}, Grafana Agent Operator is no longer the recommended way to deploy {{< param "PRODUCT_ROOT_NAME" >}} in Kubernetes.
 Some of the Operator functionality has moved into {{< param "PRODUCT_NAME" >}} itself, and the Helm Chart has replaced the remaining functionality.

docs/sources/flow/tasks/migrating-from-prometheus.md → docs/sources/flow/tasks/migrate/from-prometheus.md

@@ -1,16 +1,16 @@
 ---
 aliases:
-- /docs/grafana-cloud/agent/flow/tasks/migrating-from-prometheus/
-- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrating-from-prometheus/
-- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrating-from-prometheus/
-- /docs/grafana-cloud/send-data/agent/flow/tasks/migrating-from-prometheus/
+- /docs/grafana-cloud/agent/flow/tasks/migrate/from-prometheus/
+- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrate/from-prometheus/
+- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrate/from-prometheus/
+- /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/from-prometheus/
 # Previous page aliases for backwards compatibility:
 - /docs/grafana-cloud/agent/flow/getting-started/migrating-from-prometheus/
 - /docs/grafana-cloud/monitor-infrastructure/agent/flow/getting-started/migrating-from-prometheus/
 - /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/getting-started/migrating-from-prometheus/
 - /docs/grafana-cloud/send-data/agent/flow/getting-started/migrating-from-prometheus/
 - ../getting-started/migrating-from-prometheus/ # /docs/agent/latest/flow/getting-started/migrating-from-prometheus/
-canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrating-from-prometheus/
+canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrate/from-prometheus/
 description: Learn how to migrate from Prometheus to Grafana Agent Flow
 menuTitle: Migrate from Prometheus
 title: Migrate from Prometheus to Grafana Agent Flow

docs/sources/flow/tasks/migrating-from-promtail.md → docs/sources/flow/tasks/migrate/from-promtail.md

@@ -1,16 +1,16 @@
 ---
 aliases:
-- /docs/grafana-cloud/agent/flow/tasks/migrating-from-promtail/
-- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrating-from-promtail/
-- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrating-from-promtail/
-- /docs/grafana-cloud/send-data/agent/flow/tasks/migrating-from-promtail/
+- /docs/grafana-cloud/agent/flow/tasks/migrate/from-promtail/
+- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrate/from-promtail/
+- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrate/from-promtail/
+- /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/from-promtail/
 # Previous page aliases for backwards compatibility:
 - /docs/grafana-cloud/agent/flow/getting-started/migrating-from-promtail/
 - /docs/grafana-cloud/monitor-infrastructure/agent/flow/getting-started/migrating-from-promtail/
 - /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/getting-started/migrating-from-promtail/
 - /docs/grafana-cloud/send-data/agent/flow/getting-started/migrating-from-promtail/
 - ../getting-started/migrating-from-promtail/ # /docs/agent/latest/flow/getting-started/migrating-from-promtail/
-canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrating-from-promtail/
+canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrate/from-promtail/
 description: Learn how to migrate from Promtail to Grafana Agent Flow
 menuTitle: Migrate from Promtail
 title: Migrate from Promtail to Grafana Agent Flow

docs/sources/flow/tasks/migrating-from-static.md → docs/sources/flow/tasks/migrate/from-static.md

@@ -1,16 +1,16 @@
 ---
 aliases:
-- /docs/grafana-cloud/agent/flow/tasks/migrating-from-static/
-- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrating-from-static/
-- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrating-from-static/
-- /docs/grafana-cloud/send-data/agent/flow/tasks/migrating-from-static/
+- /docs/grafana-cloud/agent/flow/tasks/migrate/from-static/
+- /docs/grafana-cloud/monitor-infrastructure/agent/flow/tasks/migrate/from-static/
+- /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/tasks/migrate/from-static/
+- /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/from-static/
 # Previous page aliases for backwards compatibility:
 - /docs/grafana-cloud/agent/flow/getting-started/migrating-from-static/
 - /docs/grafana-cloud/monitor-infrastructure/agent/flow/getting-started/migrating-from-static/
 - /docs/grafana-cloud/monitor-infrastructure/integrations/agent/flow/getting-started/migrating-from-static/
 - /docs/grafana-cloud/send-data/agent/flow/getting-started/migrating-from-static/
 - ../getting-started/migrating-from-static/ # /docs/agent/latest/flow/getting-started/migrating-from-static/
-canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrating-from-static/
+canonical: https://grafana.com/docs/agent/latest/flow/tasks/migrate/from-static/
 description: Learn how to migrate your configuration from Grafana Agent Static to Grafana Agent Flow
 menuTitle: Migrate from Static to Flow
 title: Migrate Grafana Agent Static to Grafana Agent Flow
@@ -388,10 +388,10 @@ The following list is specific to the convert command and not {{< param "PRODUCT
 [Agent Management]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/static/configuration/agent-management.md"
 [env]: "/docs/agent/ -> /docs/agent/<AGENT_VERSION>/flow/reference/stdlib/env.md"
 [env]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/flow/reference/stdlib/env.md"
-[Prometheus Limitations]: "/docs/agent/ -> /docs/agent/<AGENT_VERSION>/flow/tasks/migrating-from-prometheus.md#limitations"
-[Prometheus Limitations]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/flow/tasks/migrating-from-prometheus.md#limitations"
-[Promtail Limitations]: "/docs/agent/ -> /docs/agent/<AGENT_VERSION>/flow/tasks/migrating-from-promtail.md#limitations"
-[Promtail Limitations]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/flow/tasks/migrating-from-promtail.md#limitations"
+[Prometheus Limitations]: "/docs/agent/ -> /docs/agent/<AGENT_VERSION>/flow/tasks/migrate/from-prometheus.md#limitations"
+[Prometheus Limitations]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/from-prometheus.md#limitations"
+[Promtail Limitations]: "/docs/agent/ -> /docs/agent/<AGENT_VERSION>/flow/tasks/migrate/from-promtail.md#limitations"
+[Promtail Limitations]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/flow/tasks/migrate/from-promtail.md#limitations"
 [Metrics]: "/docs/agent/ -> /docs/agent/<AGENT_VERSION>/static/configuration/metrics-config.md"
 [Metrics]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/send-data/agent/static/configuration/metrics-config.md"
 [Logs]: "/docs/agent/ -> /docs/agent/<AGENT_VERSION>/static/configuration/logs-config.md"