From f206f949319b4e5b00a639594c4dab140a3851bc Mon Sep 17 00:00:00 2001
From: Eunbin Son <thswlsqls@naver.com>
Date: Fri, 17 Jul 2026 05:49:51 +0900
Subject: [PATCH] Fix StringEncoder javadoc implementation priority order

---
 .../exporter/internal/marshal/StringEncoder.java           | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/exporters/common/src/main/java/io/opentelemetry/exporter/internal/marshal/StringEncoder.java b/exporters/common/src/main/java/io/opentelemetry/exporter/internal/marshal/StringEncoder.java
index 143039a58c5..e7707eb37fc 100644
--- a/exporters/common/src/main/java/io/opentelemetry/exporter/internal/marshal/StringEncoder.java
+++ b/exporters/common/src/main/java/io/opentelemetry/exporter/internal/marshal/StringEncoder.java
@@ -18,8 +18,11 @@
  * this priority order:
  *
  * <ul>
- *   <li>{@code VarHandleStringEncoder} - High-performance Java 9+ implementation using VarHandle
- *   <li>{@code UnsafeStringEncoder} - High-performance Java 8+ implementation using sun.misc.Unsafe
+ *   <li>{@code UnsafeStringEncoder} - High-performance Java 8+ implementation using
+ *       sun.misc.Unsafe. Only attempted when the Java version is detected to be below 23, to avoid
+ *       the JEP 498 deprecation warning.
+ *   <li>{@code VarHandleStringEncoder} - High-performance Java 9+ implementation using VarHandle.
+ *       Requires {@code --add-opens=java.base/java.lang=ALL-UNNAMED}.
  *   <li>{@code FallbackStringEncoder} - Implementation using standard Java operations
  * </ul>
  *