change SemenaticCvonentionVersion strategy to pin to v1.27 - the curr…

…ent version used by the library. Users must opt-in to newer versions of semantic conventions.

src/Shared/AWS/AWSSemanticConventions.cs

@@ -59,7 +59,11 @@ internal static partial class AWSSemanticConventions
     /// ]]>
     /// </code>
     /// </summary>
-    internal const SemanticConventionVersion DefaultSemanticConventionVersion = SemanticConventionVersion.Latest;
+    /// <remarks>
+    /// Per <see cref="OpenTelemetry.AWS.SemanticConventionVersion"/>, default should stay as
+    /// <see cref="SemanticConventionVersion.v1_27_0_Experimental"/> until next major version bump.
+    /// </remarks>
+    internal const SemanticConventionVersion DefaultSemanticConventionVersion = SemanticConventionVersion.v1_27_0_Experimental;
 
     #region Service Parameter Mapping
 

src/Shared/AWS/SemanticConventionVersion.cs

@@ -15,7 +15,7 @@ namespace OpenTelemetry.AWS;
 /// <para>
 /// While these libraries are intended for production use, they rely on several
 /// Semantic Conventions that are still considered Experimental, meaning they
-/// may undergo additional changes before becoming Stable.  This can  impact
+/// may undergo additional changes before becoming Stable.  This can impact
 /// the aggregation and analysis of telemetry signals in environments with
 /// multiple applications or microservices. For example, a microservice using
 /// an older version of the Semantic Conventions for Http Attributes may emit
@@ -27,8 +27,14 @@ namespace OpenTelemetry.AWS;
 /// Future versions the OpenTelemetry.*.AWS libraries will include updates
 /// to the Semantic Convention, which may break compatibility with a previous
 /// version.
+/// </para>
+/// <para>
+/// The default will remain as <see cref="v1_27_0_Experimental"/> until the next major version
+/// bump.
+/// </para>
 /// <para>
-/// To opt-out of automatic upgrades, you can pin to a specific version:
+/// To opt in to automatic upgrades, you can use <see cref="SemanticConventionVersion.Latest"/>
+/// or you can specify a specific version:
 /// </para>
 /// <code>
 /// <![CDATA[