Merge pull request #443 from mikereiche/release/3.8

Release 3.8.0

Author: RichardSmedley

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::
     <dependency>
         <groupId>com.couchbase.client</groupId>
         <artifactId>java-client</artifactId>
-        <version>3.7.6</version>
+        <version>3.8.0</version>
     </dependency>
 </dependencies>
 ----
@@ -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'
 ----
 --
 ====

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 '<version>' $src/metrics-opentelemetry/pom.xml
 echo metrics-micrometer ; grep '<version>' $src/metrics-micrometer/pom.xml | head -2 | tail -1 ; grep '<micrometer.version>' $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]: