diff --git a/modules/hello-world/pages/start-using-sdk.adoc b/modules/hello-world/pages/start-using-sdk.adoc
index 2ca75d0e..171897e0 100644
--- a/modules/hello-world/pages/start-using-sdk.adoc
+++ b/modules/hello-world/pages/start-using-sdk.adoc
@@ -11,10 +11,10 @@
// https://github.com/couchbase/docs-sdk-common/blob/release/7.6/modules/shared/partials/start-using-sdk.adoc
//
// and code samples from
-// https://github.com/couchbase/docs-sdk-java/tree/release/3.7/modules/devguide/examples/java
+// https://github.com/couchbase/docs-sdk-java/tree/release/3.8/modules/devguide/examples/java
//
// It can be seen built at
-// https://docs.couchbase.com/java-sdk/3.7/hello-world/start-using-sdk.html
+// https://docs.couchbase.com/java-sdk/3.8/hello-world/start-using-sdk.html
[abstract]
@@ -636,7 +636,7 @@ Maven::
com.couchbase.client
java-client
- 3.7.6
+ 3.8.0
----
@@ -647,7 +647,7 @@ Gradle::
--
[source,groovy]
----
-implementation 'com.couchbase.client:java-client:3.7.6'
+implementation 'com.couchbase.client:java-client:3.8.0'
----
--
====
diff --git a/modules/project-docs/pages/sdk-release-notes.adoc b/modules/project-docs/pages/sdk-release-notes.adoc
index 79b19a4d..beb38723 100644
--- a/modules/project-docs/pages/sdk-release-notes.adoc
+++ b/modules/project-docs/pages/sdk-release-notes.adoc
@@ -27,6 +27,10 @@ We always recommend using the latest version of the SDK -- it contains all of th
All patch releases for each dot minor release should be API compatible, and safe to upgrade;
any changes to expected behavior are noted in the release notes that follow.
+Version 3.8 of the Java SDK implements the 3.7 xref:compatibility.adoc#api-version[SDK API].
+See the xref:compatibility.adoc#couchbase-feature-availability-matrix[compatibility pages] for more information on feature compatibility with different versions of Couchbase Server.
+
+
////
# get version numbers like this
src=../couchbase-jvm-clients
@@ -38,10 +42,7 @@ echo metrics-opentelemetry ; grep '' $src/metrics-opentelemetry/pom.xml
echo metrics-micrometer ; grep '' $src/metrics-micrometer/pom.xml | head -2 | tail -1 ; grep '' $src/pom.xml
////
-
-
-
-=== Version 3.8.0 (1 April 2025)
+=== Version 3.8.0 (9 April 2025)
This is the first release of the 3.8 series.
@@ -51,13 +52,51 @@ http://docs.couchbase.com/sdk-api/couchbase-core-io-3.8.0/[Core API Reference]
The supported and tested dependencies for this release are:
-*
+* io.projectreactor:**reactor-core:3.6.9**
+* org.reactivestreams:**reactive-streams:1.0.4**
+
+Optional artifacts on top of this SDK version are tested for the following compatibilities:
+
+.Optional Artifact Version Compatibility
+[options="header"]
+|=======================
+| Artifact | Couchbase Version | Built Against | API Stability
+| `tracing-opentelemetry` | 1.6.0 | OpenTelemetry 1.31.0 | Committed
+| `tracing-opentracing` | 1.6.0 | OpenTracing 0.33.0 | Committed
+| `metrics-opentelemetry` | 0.8.0 | OpenTelemetry 1.31.0 | Volatile
+| `metrics-micrometer` | 0.8.0 | Micrometer 1.12.9 | Volatile
+|=======================
+
+
+==== Bugfixes
+
+* https://couchbasecloud.atlassian.net/browse/JVMCBC-1628[JVMCBC-1628]:
+Specifying `DISABLE_READ_SKEW_DETECTION` was causing transactional `getMulti` to fail.
+This has now been fixed.
+
+==== New Features
+* https://couchbasecloud.atlassian.net/browse/JVMCBC-1602:[JVMCBC-1602]:
+Application Telemetry improvements.
+
+==== Improvements
+
+https://couchbasecloud.atlassian.net/browse/JCBC-2183[JCBC-2183]:
+Implemented `ExtGetMulti` (aka Enhanced Read Committed Isolation).
+
+https://couchbasecloud.atlassian.net/browse/JCBC-2186[JCBC-2186]:
+Updated Bucket & Storage Support in SDKs.
+
+https://couchbasecloud.atlassian.net/browse/JCBC-2186[JCBC-2147]:
+Added `PREFERRED_SERVER_GROUP_OR_ALL_AVAILABLE` support.
== Java SDK 3.7 Releases
+Version 3.7 of the Java SDK implements the 3.6 xref:compatibility.adoc#api-version[SDK API].
+See the xref:compatibility.adoc#couchbase-feature-availability-matrix[compatibility pages] for more information on feature compatibility with different versions of Couchbase Server.
+
=== Version 3.7.9 (11 March 2025)
@@ -162,12 +201,14 @@ Optional artifacts on top of this SDK version are tested for the following compa
|=======================
==== Bug Fixes
+
* https://jira.issues.couchbase.com/browse/JVMCBC-1592[JVMCBC-1592]:
When fetching fresh cluster topology information for a bucket, the SDK now dispatches the request to a random eligible node instead of using a round-robin algorithm. Randomizing the node selection avoids a pathological condition where if the number of open buckets is equal to the number of nodes, and one of the nodes is degraded, the config refresh attempt for a particular bucket would fail repeatedly because it was always sent to the degraded node.
* https://jira.issues.couchbase.com/browse/JCBC-2152[JCBC-2152]:
Return the inserted document in the form of a TransactionGetResult instead of the old content from the Get operation.
==== Improvements
+
* https://jira.issues.couchbase.com/browse/JVMCBC-1585[JVMCBC-1585]:
When a thread executing clusterOrScope.queryStreaming() is interrupted, the thrown CancellationException now has the original InterruptedException as its cause.
* https://jira.issues.couchbase.com/browse/JCBC-2174[JCBC-2174]: