From e1dd0194551017a06ce3ace9a368ad83cbf8d254 Mon Sep 17 00:00:00 2001
From: Matt McCleary <43887470+mattmccleary@users.noreply.github.com>
Date: Fri, 16 Feb 2024 14:24:31 -0800
Subject: [PATCH] Add Caution Note re Experimental SemConvs (#3995)

---
 content/en/docs/languages/_index.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/content/en/docs/languages/_index.md b/content/en/docs/languages/_index.md
index 2b44d21a412..f1ae703374f 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/