diff --git a/docs/rfcs/0008-backwards-compatibility.md b/docs/rfcs/0008-backwards-compatibility.md index 56d4bac647a3..28d4c23c2e50 100644 --- a/docs/rfcs/0008-backwards-compatibility.md +++ b/docs/rfcs/0008-backwards-compatibility.md @@ -63,6 +63,8 @@ It's impossible to guarantee that full backwards compatibility is achieved. Ther - Other telemetry data: metrics, logs, and traces may change between releases. Only telemetry data which is used in official dashboards is protected under backwards compatibility. +- Tagged as exempt: functionality which is explicitly marked as exempt from backwards compatibility guarantees may include breaking changes or removal between minor releases. + ### Avoiding major release burnout  As a new major release implies a user must put extra effort into upgrading, it is possible to burn out users by releasing breaking changes too frequently.  diff --git a/docs/sources/flow/reference/cli/convert.md b/docs/sources/flow/reference/cli/convert.md index 3b44d662e87a..793acfb2031a 100644 --- a/docs/sources/flow/reference/cli/convert.md +++ b/docs/sources/flow/reference/cli/convert.md @@ -17,6 +17,10 @@ weight: 100 The `convert` command converts a supported configuration format to {{< param "PRODUCT_NAME" >}} River format. +{{< admonition type="caution" >}} +This command has no backward compatibility guarantees and may change or be removed between releases. +{{< /admonition >}} + ## Usage Usage: @@ -113,4 +117,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/migrate/from-static/" >}}) for a detailed migration guide. \ No newline at end of file +Refer to [Migrate from Grafana Agent Static to {{< param "PRODUCT_NAME" >}}]({{< relref "../../tasks/migrate/from-static/" >}}) for a detailed migration guide.