Replace hardcoded OTel version with $otelVersion-alpha marker

The script strips the -alpha suffix so $otelVersion resolves to
the base version (e.g. 2.24.0), and docs write $otelVersion-alpha
explicitly to produce the full version string.

Signed-off-by: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>

Author: zeitlinger

.mise/tasks/set-release-version-github-pages.sh

@@ -5,5 +5,8 @@
 set -euox pipefail
 
 version=$(git tag -l | grep 'v' | sort | tail -1 | sed 's/v//')
-marker="\$version"
-find ./docs/content -name '*.md' -exec sed -i "s/$marker/$version/g" {} +
+otelVersion=$(grep -oP '<otel.instrumentation.version>\K[^<]+' pom.xml | sed 's/-alpha$//')
+
+find ./docs/content -name '*.md' \
+	-exec sed -i "s/\$version/$version/g" {} + \
+	-exec sed -i "s/\$otelVersion/$otelVersion/g" {} +

CLAUDE.md

@@ -123,7 +123,7 @@ mise run lint:super-linter
 
 - Docs live under `docs/content/` and use `$version` as a placeholder for the library version
 - When publishing GitHub Pages, `mise run set-release-version-github-pages` replaces `$version` with the latest git tag across all `docs/content/**/*.md` files (the published site is not versioned)
-- When writing docs, always use `$version` for the Prometheus client version — never hardcode it
+- Use `$version` for the Prometheus client version and `$otelVersion-alpha` for the OTel instrumentation version — never hardcode them
 
 ## Java Version
 

docs/content/otel/jvm-runtime-metrics.md

@@ -36,7 +36,9 @@ implementation 'io.prometheus:prometheus-metrics-otel-support:$version'
 
 // Use opentelemetry-runtime-telemetry-java8 (Java 8+)
 // or opentelemetry-runtime-telemetry-java17 (Java 17+, JFR-based)
-implementation 'io.opentelemetry.instrumentation:opentelemetry-runtime-telemetry-java8:2.24.0-alpha'
+implementation(
+    'io.opentelemetry.instrumentation:opentelemetry-runtime-telemetry-java8:$otelVersion-alpha'
+)
 ```
 
 {{< /tab >}}
@@ -55,14 +57,14 @@ implementation 'io.opentelemetry.instrumentation:opentelemetry-runtime-telemetry
 <dependency>
     <groupId>io.opentelemetry.instrumentation</groupId>
     <artifactId>opentelemetry-runtime-telemetry-java8</artifactId>
-    <version>2.24.0-alpha</version>
+    <version>$otelVersion-alpha</version>
 </dependency>
 <!-- Java 17+ (adds JFR-based metrics) -->
 <!--
 <dependency>
     <groupId>io.opentelemetry.instrumentation</groupId>
     <artifactId>opentelemetry-runtime-telemetry-java17</artifactId>
-    <version>2.24.0-alpha</version>
+    <version>$otelVersion-alpha</version>
 </dependency>
 -->
 ```