drop the suffix expiremental in enum values and instead metnion exper…

…imental status in documentation

src/OpenTelemetry.Instrumentation.AWS/.publicApi/PublicAPI.Unshipped.txt

@@ -1,8 +1,8 @@
 #nullable enable
 OpenTelemetry.Instrumentation.AWS.SemanticConventionVersion
 OpenTelemetry.Instrumentation.AWS.SemanticConventionVersion.Latest = 0 -> OpenTelemetry.Instrumentation.AWS.SemanticConventionVersion
-OpenTelemetry.Instrumentation.AWS.SemanticConventionVersion.V1_29_0_Experimental = 2 -> OpenTelemetry.Instrumentation.AWS.SemanticConventionVersion
-OpenTelemetry.Instrumentation.AWS.SemanticConventionVersion.V1_28_0_Experimental = 1 -> OpenTelemetry.Instrumentation.AWS.SemanticConventionVersion
+OpenTelemetry.Instrumentation.AWS.SemanticConventionVersion.V1_29_0 = 2 -> OpenTelemetry.Instrumentation.AWS.SemanticConventionVersion
+OpenTelemetry.Instrumentation.AWS.SemanticConventionVersion.V1_28_0 = 1 -> OpenTelemetry.Instrumentation.AWS.SemanticConventionVersion
 OpenTelemetry.Instrumentation.AWS.AWSClientInstrumentationOptions
 OpenTelemetry.Instrumentation.AWS.AWSClientInstrumentationOptions.AWSClientInstrumentationOptions() -> void
 OpenTelemetry.Instrumentation.AWS.AWSClientInstrumentationOptions.SemanticConventionVersion.get -> OpenTelemetry.Instrumentation.AWS.SemanticConventionVersion

src/OpenTelemetry.Instrumentation.AWS/README.md

@@ -53,7 +53,7 @@ emit the GET as `"http.request.method"`.
 Future versions the OpenTelemetry.*.AWS libraries will include updates to the
 Semantic Convention, which may break compatibility with a previous version.
 
-The default will remain as `V1_28_0_Experimental` until the next major version bump.
+The default will remain as `V1_28_0` until the next major version bump.
 
 To opt in to automatic upgrades, you can use `SemanticConventionVersion.Latest`
 or you can specify a specific version:
@@ -70,7 +70,7 @@ public void ConfigureServices(IServiceCollection services)
     services.AddOpenTelemetryTracing((builder) => builder
         .AddAWSInstrumentation(opt => {
             // pin to a specific Semantic Convention version
-            opt.SemanticConventionVersion = SemanticConventionVersion.V1_29_0_Experimental;
+            opt.SemanticConventionVersion = SemanticConventionVersion.V1_29_0;
         });
 }
 ```

src/OpenTelemetry.Instrumentation.AWSLambda/.publicApi/PublicAPI.Unshipped.txt

@@ -1,8 +1,8 @@
 #nullable enable
 OpenTelemetry.Instrumentation.AWSLambda.SemanticConventionVersion
 OpenTelemetry.Instrumentation.AWSLambda.SemanticConventionVersion.Latest = 0 -> OpenTelemetry.Instrumentation.AWSLambda.SemanticConventionVersion
-OpenTelemetry.Instrumentation.AWSLambda.SemanticConventionVersion.V1_29_0_Experimental = 2 -> OpenTelemetry.Instrumentation.AWSLambda.SemanticConventionVersion
-OpenTelemetry.Instrumentation.AWSLambda.SemanticConventionVersion.V1_28_0_Experimental = 1 -> OpenTelemetry.Instrumentation.AWSLambda.SemanticConventionVersion
+OpenTelemetry.Instrumentation.AWSLambda.SemanticConventionVersion.V1_29_0 = 2 -> OpenTelemetry.Instrumentation.AWSLambda.SemanticConventionVersion
+OpenTelemetry.Instrumentation.AWSLambda.SemanticConventionVersion.V1_28_0 = 1 -> OpenTelemetry.Instrumentation.AWSLambda.SemanticConventionVersion
 OpenTelemetry.Instrumentation.AWSLambda.AWSLambdaInstrumentationOptions
 OpenTelemetry.Instrumentation.AWSLambda.AWSLambdaInstrumentationOptions.AWSLambdaInstrumentationOptions() -> void
 OpenTelemetry.Instrumentation.AWSLambda.AWSLambdaInstrumentationOptions.DisableAwsXRayContextExtraction.get -> bool

src/OpenTelemetry.Instrumentation.AWSLambda/README.md

@@ -160,7 +160,7 @@ Future versions of OpenTelemetry.Instrumentation.AWSLambda library will include
 updates to the Semantic Convention, which may break compatibility with a
 previous version.
 
-The default will remain as `V1_28_0_Experimental` until the next major version bump.
+The default will remain as `V1_28_0` until the next major version bump.
 
 To opt in to automatic upgrades, you can use `SemanticConventionVersion.Latest`
 or you can specify a specific version:
@@ -170,7 +170,7 @@ or you can specify a specific version:
     .AddAWSLambdaConfigurations(opt =>
     {
         // pin to a specific Semantic Convention version
-        opt.SemanticConventionVersion = SemanticConventionVersion.V1_29_0_Experimental;
+        opt.SemanticConventionVersion = SemanticConventionVersion.V1_29_0;
     })
     .Build()!);
 ```

src/OpenTelemetry.Resources.AWS/.publicApi/PublicAPI.Unshipped.txt

@@ -1,7 +1,7 @@
 OpenTelemetry.Resources.AWS.SemanticConventionVersion
 OpenTelemetry.Resources.AWS.SemanticConventionVersion.Latest = 0 -> OpenTelemetry.Resources.AWS.SemanticConventionVersion
-OpenTelemetry.Resources.AWS.SemanticConventionVersion.V1_29_0_Experimental = 2 -> OpenTelemetry.Resources.AWS.SemanticConventionVersion
-OpenTelemetry.Resources.AWS.SemanticConventionVersion.V1_28_0_Experimental = 1 -> OpenTelemetry.Resources.AWS.SemanticConventionVersion
+OpenTelemetry.Resources.AWS.SemanticConventionVersion.V1_29_0 = 2 -> OpenTelemetry.Resources.AWS.SemanticConventionVersion
+OpenTelemetry.Resources.AWS.SemanticConventionVersion.V1_28_0 = 1 -> OpenTelemetry.Resources.AWS.SemanticConventionVersion
 OpenTelemetry.Resources.AWS.AWSResourceBuilderOptions
 OpenTelemetry.Resources.AWS.AWSResourceBuilderOptions.AWSResourceBuilderOptions() -> void
 OpenTelemetry.Resources.AWS.AWSResourceBuilderOptions.SemanticConventionVersion.get -> OpenTelemetry.Resources.AWS.SemanticConventionVersion

src/OpenTelemetry.Resources.AWS/README.md

@@ -83,7 +83,7 @@ emit the GET as `"http.request.method"`.
 Future versions the OpenTelemetry.*.AWS libraries will include updates to the
 Semantic Convention, which may break compatibility with a previous version.
 
-The default will remain as `V1_28_0_Experimental` until the next major version bump.
+The default will remain as `V1_28_0` until the next major version bump.
 
 To opt in to automatic upgrades, you can use `SemanticConventionVersion.Latest`
 or you can specify a specific version:
@@ -96,7 +96,7 @@ using var tracerProvider = Sdk.CreateTracerProviderBuilder()
     .ConfigureResource(resource => resource.AddAWSEC2Detector(
         opt => {
             // pin to a specific Semantic Convention version
-            opt.SemanticConventionVersion = SemanticConventionVersion.V1_29_0_Experimental;
+            opt.SemanticConventionVersion = SemanticConventionVersion.V1_29_0;
         }
     ))
     // other configurations

src/Shared/AWS/AWSSemanticConventions.cs

@@ -64,9 +64,9 @@ internal partial class AWSSemanticConventions
     /// </summary>
     /// <remarks>
     /// Per SemanticConventionVersion, default should stay as
-    /// <see cref="SemanticConventionVersion.V1_28_0_Experimental"/> until next major version bump.
+    /// <see cref="SemanticConventionVersion.V1_28_0"/> until next major version bump.
     /// </remarks>
-    internal const SemanticConventionVersion DefaultSemanticConventionVersion = SemanticConventionVersion.V1_28_0_Experimental;
+    internal const SemanticConventionVersion DefaultSemanticConventionVersion = SemanticConventionVersion.V1_28_0;
 
     private readonly SemanticConventionVersion semanticConventionVersion;
 
@@ -482,10 +482,10 @@ private AWSSemanticConventionsBase GetSemanticConventionVersion()
         switch (this.semanticConventionVersion)
         {
             case SemanticConventionVersion.Latest:
-            case SemanticConventionVersion.V1_29_0_Experimental:
+            case SemanticConventionVersion.V1_29_0:
                 return new AWSSemanticConventions_V1_29_0();
 
-            case SemanticConventionVersion.V1_28_0_Experimental:
+            case SemanticConventionVersion.V1_28_0:
                 return new AWSSemanticConventions_V1_28_0();
 
             default:

src/Shared/AWS/SemanticConventionVersion.cs

@@ -37,7 +37,7 @@ namespace OpenTelemetry.Resources.AWS;
 /// version.
 /// </para>
 /// <para>
-/// The default will remain as <see cref="V1_28_0_Experimental"/> until the next major version
+/// The default will remain as <see cref="V1_28_0"/> until the next major version
 /// bump.
 /// </para>
 /// <para>
@@ -50,7 +50,7 @@ namespace OpenTelemetry.Resources.AWS;
 ///  using (var tracerProvider = Sdk.CreateTracerProviderBuilder()
 ///     .AddAWSLambdaConfigurations(opt =>
 ///     {
-///         opt.SemanticConventionVersion = SemanticConventionVersion.V1_29_0_Experimental;
+///         opt.SemanticConventionVersion = SemanticConventionVersion.V1_29_0;
 ///     })
 ///     .Build()!);
 /// ]]>
@@ -77,13 +77,17 @@ public enum SemanticConventionVersion
     /// Pin to the specific state of all Semantic Conventions as of the 1.28.0
     /// release. See:
     /// https://github.com/open-telemetry/semantic-conventions/releases/tag/v1.28.0.
+    /// <para />
+    /// This version contains conventions marked Experimental and may change in future versions.
     /// </summary>
-    V1_28_0_Experimental = 1,
+    V1_28_0 = 1,
 
     /// <summary>
     /// Pin to the specific state of all Semantic Conventions as of the 1.29.0
     /// release. See:
     /// https://github.com/open-telemetry/semantic-conventions/releases/tag/v1.29.0.
+    /// <para />
+    /// This version contains conventions marked Experimental and may change in future versions.
     /// </summary>
-    V1_29_0_Experimental = 2,
+    V1_29_0 = 2,
 }

test/OpenTelemetry.Instrumentation.AWS.Tests/AWSClientInstrumentationOptionsTests.cs

@@ -25,7 +25,7 @@ public sealed class AWSClientInstrumentationOptionsTests
     [Fact]
     public void CanUseSemanticConvention_V1_28_0()
     {
-        var semanticVersion = SemanticConventionVersion.V1_28_0_Experimental;
+        var semanticVersion = SemanticConventionVersion.V1_28_0;
 
         var tags = this.GetActivityTags(semanticVersion);
 
@@ -36,7 +36,7 @@ public void CanUseSemanticConvention_V1_28_0()
     [Fact]
     public void CanUseSemanticConvention_V1_29_0()
     {
-        var semanticVersion = SemanticConventionVersion.V1_29_0_Experimental;
+        var semanticVersion = SemanticConventionVersion.V1_29_0;
 
         var tags = this.GetActivityTags(semanticVersion);