diff --git a/antora.yml b/antora.yml index 8d2e3a16..b16895d3 100644 --- a/antora.yml +++ b/antora.yml @@ -19,6 +19,7 @@ asciidoc: sdk_dot_major: '3.x' version-server: '7.6' version-common: '8.0' + java_latest_lts_version: '25' name_platform: 'Java' name-sdk: Java SDK sdk_api: '3.8' diff --git a/modules/hello-world/pages/start-using-sdk.adoc b/modules/hello-world/pages/start-using-sdk.adoc index 24fdee26..06b56fdd 100644 --- a/modules/hello-world/pages/start-using-sdk.adoc +++ b/modules/hello-world/pages/start-using-sdk.adoc @@ -93,7 +93,7 @@ For the example code below to run, you'll need the username and password of the * The Java SDK is tested against LTS versions of Oracle JDK and OpenJDK -- see the xref:project-docs:compatibility.adoc#jdk-compat[compatibility docs]. + -https://adoptium.net/[OpenJDK 21 with HotSpot JVM] is recommended. +https://adoptium.net/[OpenJDK {java_latest_lts_version} with HotSpot JVM] is recommended. The code examples also assume: @@ -134,7 +134,7 @@ In production, Couchbase strongly recommends setting up users with more granular == Installation -We recommend running the latest Java LTS version (i.e. at the time of writing JDK 21) with the highest patch version available. +We recommend running the latest Java LTS version (i.e. at the time of writing JDK {java_latest_lts_version}) with the highest patch version available. // Other supported Java versions will work, too. Couchbase publishes all stable artifacts to https://central.sonatype.com/namespace/com.couchbase.client[Maven Central]. @@ -625,7 +625,7 @@ include:devguide::example$StartUsing.java[tags=start-using,indent=0] == Quick Installation -We recommend running the latest Java LTS version (i.e. at the time of writing JDK 21) with the highest patch version available. +We recommend running the latest Java LTS version (i.e. at the time of writing JDK {java_latest_lts_version}) with the highest patch version available. // Other supported Java versions will work, too. Couchbase publishes all stable artifacts to https://central.sonatype.com/namespace/com.couchbase.client[Maven Central]. diff --git a/modules/hello-world/pages/student-record-developer-tutorial.adoc b/modules/hello-world/pages/student-record-developer-tutorial.adoc index 292dbae8..04854e60 100644 --- a/modules/hello-world/pages/student-record-developer-tutorial.adoc +++ b/modules/hello-world/pages/student-record-developer-tutorial.adoc @@ -17,8 +17,8 @@ If you wish to use a standalone or Docker installation of Couchbase, see the xre * Before starting this tutorial, you must have a Couchbase Capella account. If you do not have one already, xref:cloud:get-started:create-account.adoc[Create an Account]. -* Install the Java Software Development Kit (JDK) -- Couchbase JVM SDKs are compatible with version 8, 11, 17, or 21. -** The recommended version is the latest Java LTS release, which is currently https://adoptium.net/en-GB/[JDK 21]. +* Install the Java Software Development Kit (JDK) -- Couchbase JVM SDKs are compatible with LTS versions of Java. +** The recommended version is the latest Java LTS release, which is currently https://adoptium.net/[JDK {java_latest_lts_version}]. Ensure you install the highest available patch for the LTS version. * Install Apache Maven (version 3+) diff --git a/modules/project-docs/pages/compatibility.adoc b/modules/project-docs/pages/compatibility.adoc index a44f325e..7ab13872 100644 --- a/modules/project-docs/pages/compatibility.adoc +++ b/modules/project-docs/pages/compatibility.adoc @@ -10,7 +10,8 @@ Plus notes on Cloud, networks, and AWS Lambda. {description} -The {sdk_dot_minor} SDK requires Java 8 or later to be installed, _Java 21 is recommended_. +The {sdk_dot_minor} SDK requires Java 8 or later to be installed. +_Java {java_latest_lts_version} is recommended_. @@ -21,11 +22,12 @@ The {sdk_dot_minor} SDK requires Java 8 or later to be installed, _Java 21 is re The {name-sdk} is tested with Oracle JDK and OpenJDK. Other JDK implementations might work but are not tested and are unsupported. -We recommend running the latest LTS version (i.e. at the time of writing JDK 21) with the highest patch version available. +We recommend running the latest LTS version (i.e. at the time of writing JDK {java_latest_lts_version}) with the highest patch version available. The following JDK releases are supported: -* https://adoptium.net/[OpenJDK 21 with HotSpot JVM] (recommended) +* https://adoptium.net/[OpenJDK 25 with HotSpot JVM] (recommended) +* https://adoptium.net/[OpenJDK 21 with HotSpot JVM] * https://adoptium.net/[OpenJDK 17 with HotSpot JVM] * https://www.oracle.com/java/technologies/downloads/#jdk17[Oracle JDK 17] * https://adoptium.net/[OpenJDK 11] (Hotspot recommended) or https://www.oracle.com/java/technologies/downloads/#jdk11[Oracle JDK 11] diff --git a/modules/project-docs/pages/migrating-sdk-code-to-3.n.adoc b/modules/project-docs/pages/migrating-sdk-code-to-3.n.adoc index 80deba10..f0395f5b 100644 --- a/modules/project-docs/pages/migrating-sdk-code-to-3.n.adoc +++ b/modules/project-docs/pages/migrating-sdk-code-to-3.n.adoc @@ -46,7 +46,7 @@ The Java SDK 3.x is available for download from the same resources as the previo In addition, a `zip` file is available with the required jars. Please see the xref:sdk-release-notes.adoc[Release Notes] for up-to-date information. -IMPORTANT: Java SDK 3.x has a minimum required Java version of 8, although we recommend running the latest LTS version (i.e. at the time of writing JDK 21) with the highest patch version available. +IMPORTANT: Java SDK 3.x has a minimum required Java version of 8, although we recommend running the latest LTS version (i.e. at the time of writing JDK {java_latest_lts_version}) with the highest patch version available. Note that the transitive dependency list has changed. As a refresher, Java SDK 2 depended on the following artifacts: diff --git a/modules/project-docs/pages/sdk-full-installation.adoc b/modules/project-docs/pages/sdk-full-installation.adoc index 432259da..91988361 100644 --- a/modules/project-docs/pages/sdk-full-installation.adoc +++ b/modules/project-docs/pages/sdk-full-installation.adoc @@ -28,7 +28,7 @@ The underlying OS normally makes no difference, but library incompatibilities in At least Java 8 is required for current releases; see the xref:project-docs:compatibility.adoc#jdk-compat[Compatibility] section for details. -We recommend running the latest Java LTS version (i.e. at the time of writing JDK 21) with the highest patch version available. +We recommend running the latest Java LTS version (i.e. at the time of writing JDK {java_latest_lts_version}) with the highest patch version available. Couchbase publishes all stable artifacts to https://central.sonatype.com/namespace/com.couchbase.client[Maven Central]. The latest version of the {sdk_dot_minor} SDK is https://central.sonatype.com/artifact/com.couchbase.client/java-client/{sdk_current_version}/jar[{sdk_current_version}].