diff --git a/content/en/docs/languages/_index.md b/content/en/docs/languages/_index.md index 2b44d21a4121..f1ae703374f6 100644 --- a/content/en/docs/languages/_index.md +++ b/content/en/docs/languages/_index.md @@ -25,6 +25,18 @@ Java, Node.js, Python, Go into your application. The current status of the major functional components for OpenTelemetry is as follows: +{{% alert title="Important" color="warning" %}} + +Regardless of an API/SDK's status, if your instrumentation relies on [semantic +conventions] that are marked as [Experimental] in the [semantic conventions +specification], your data flow might be subject to **breaking changes**. + +[semantic conventions]: /docs/concepts/semantic-conventions/ +[Experimental]: /docs/specs/otel/document-status/ +[semantic conventions specification]: /docs/specs/semconv/ + +{{% /alert %}} + {{% telemetry-support-table " " %}} [auto]: /docs/kubernetes/operator/automatic/