Update docs/changelog/126843.yaml

Author: DaveCTurner

docs/changelog/126843.yaml

@@ -1,23 +1,20 @@
 pr: 126843
 summary: Upgrade `repository-s3` to AWS SDK v2
 area: Snapshot/Restore
-type: breaking
+type: "breaking, upgrade"
 issues:
  - 120993
+highlight:
+  title: Upgrade `repository-s3` to AWS SDK v2
+  body: "Closes #120993"
+  notable: true
 breaking:
   title: Upgrade `repository-s3` to AWS SDK v2
   area: Cluster and node setting
-  details: >-
-
-    In earlier versions of {es} the `repository-s3` plugin was based on the AWS
-    SDK v1. AWS will withdraw support for this SDK before the end of the life
-    of {es} {minor-version} so we must migrate to the newer AWS SDK v2.
-
-    Unfortunately there are several differences between the two AWS SDK
-    versions which may require you to adjust your system configuration when
-    upgrading to {es} {minor-version} or later. These differences include, but
-    may not be limited to, the following items.
+  details: |2-
 
+    In earlier versions of {es} the `repository-s3` plugin was based on the AWS SDK v1. AWS will withdraw support for this SDK before the end of the life of {es} {minor-version} so we must migrate to the newer AWS SDK v2.
+    Unfortunately there are several differences between the two AWS SDK versions which may require you to adjust your system configuration when upgrading to {es} {minor-version} or later. These differences include, but may not be limited to, the following items.
     * AWS SDK v2 requires users to specify the region to use for signing
       requests, or else to run in an environment in which it can determine the
       correct region automatically. The older SDK would try to determine the
@@ -27,7 +24,6 @@ breaking:
       `us-east-1` if no better value could be found.
 
     * AWS SDK v2 does not support the EC2 IMDSv1 protocol.
-
     * AWS SDK v2 does not support the
       `com.amazonaws.sdk.ec2MetadataServiceEndpointOverride` system property.
 
@@ -44,21 +40,14 @@ breaking:
       longer has any effect.
 
     * AWS SDK v2 does not support the `log-delivery-write` canned ACL.
-
     * AWS SDK v2 counts 4xx responses differently in its metrics reporting.
-
     * AWS SDK v2 always uses the regional STS endpoint, whereas AWS SDK v2
       could use either a regional endpoint or the global
       `https://sts.amazonaws.com` one.
+  impact: |2-
 
-  impact: >-
-
-    If you use the `repository-s3` module, test your upgrade thoroughly before
-    upgrading any production workloads.
-
-    Adapt your configuration to the new SDK functionality. This includes, but
-    may not be limited to, the following items.
-
+    If you use the `repository-s3` module, test your upgrade thoroughly before upgrading any production workloads.
+    Adapt your configuration to the new SDK functionality. This includes, but may not be limited to, the following items.
     * Specify the correct signing region using the
       `s3.client.${CLIENT_NAME}.region` setting on each node. {es} will try and
       determine the correct region based on the endpoint URL and other data
@@ -77,5 +66,4 @@ breaking:
       which starts with `http://`.
 
     * If applicable, discontinue use of the `log-delivery-write` canned ACL.
-
   notable: true