Update compatibility.adoc

DOC-13974
DOC-13557
DOC-13603

Author: RichardSmedley

modules/project-docs/pages/compatibility.adoc

@@ -43,37 +43,33 @@ Please make sure you run on one of the latest patch releases, since they provide
 In general, the JVM eliminates concerns about underlying OS compatibility, 
 and Couchbase JVM SDKs can be expected to run on all of the Operating Systems supported by xref:{version-server}@server:install:install-platforms.adoc[Couchbase Server].
 
-The {name-sdk} is tested and supported on the following OSs and platforms:
+
+The {name-sdk} will run on, and is supported on, the following OSs and platforms.
+The SDK has been tested on a representative subset of the platforms listed below.
 
 ****
 [discrete]
 === GNU/Linux
 
 * Amazon Linux 2 & AL2023.
-* Red Hat Enterprise Linux 8 & 9;
-* Oracle Linux 8 & 9.
+* Red Hat Enterprise Linux 8, 9, & 10.
+* Oracle Linux 8, 9, & 10.
 * Ubuntu (LTS) 22.04 (_Jammy_) & 24.04 (_Noble_).
-* Debian 11 (_Bullseye_) & Debian 12 (_Bookworm_).
-* SUSE Enterprise Linux 12 & 15
-* Alpine Linux 3.18 (_Oracle JDK only_) -- but see <<alpine-linux-compatibility, workaround note below>>.
+* Debian 11 (_Bullseye_), Debian 12 (_Bookworm_), & Debian 13 (_Trixie_).
+* SUSE Enterprise Linux 12 & 15.
+* Alpine Linux 3.21 - 3.23.
 
 [discrete]
 === Microsoft Windows
 
 * Microsoft Windows 10 & 11;
-* Windows Server 2019 & 2022.
+* Windows Server 2019, 2022, & 2025.
 
 [discrete]
 === Mac OS X
 
 The current and previous two releases of OS X.
-At time of writing (April 2025): 15 (Sequoia), 14 (Sonoma), and 13 (Ventura).
-M1 ARM  architecture is fully supported in the {name-sdk}.
-
-[discrete]
-=== ARM Processor Support
-
-AWS Amazon Graviton2, Apple M1 ARM processors, and ARMv8 on Ubuntu 20.04+ (from SDK 3.4).
+At time of writing (February 2026): 26 (Tahoe), 15 (Sequoia), and 14 (Sonoma).
 ****
 
 The JVM SDKs should also be expected to run on other commonly-available GNU/Linux distributions which support an appropriate JDK, but not all combinations can be tested -- notable exceptions are listed below.
@@ -135,34 +131,38 @@ The matrix below denotes the version of Couchbase Server, the version of the {na
 
 * ✖ *Unsupported*: This combination is not tested, and is not within the scope of technical support if you have purchased a support agreement.
 * ◎ *Compatible*: This combination has been tested previously, and should be compatible.
-This combination is not recommended by our technical support organization.
+evertheless, this combination is not recommended by our technical support organization, as not all of the latest features are supported by it.
 It is best to upgrade either the SDK or the Couchbase version you are using.
 * ✔ *Supported*: This combination is subject to ongoing quality assurance, and is fully supported by our technical support organization.
 
 .Recommended SDK per Server Version Matrix
 [#table_sdk_versions]
 |===
-| | 3.4, 3.5 | 3.6, 3.7 | 3.8 | 3.9, 3.10
+| | 3.4, 3.5 | 3.6, 3.7 | 3.8 | 3.9-3.11
 
-| *Server 7.0 - 7.2*
+| *Server 8.0* ①
 | *✔*
 | *✔*
 | *✔*
 | *✔*
 
-| *Server 7.6*
+| *Server 7.6* ①
 | *✔*
 | *✔*
 | *✔*
 | *✔*
 
-| *Server 8.0*
+| *Server 7.2*
 | *◎*
 | *◎*
 | *✔*
 | *✔*
 |===
 
+
+① Server 7.6 & 8.0 are compatible with all supported (not yet End-of-Life) versions of the {name-sdk}, but for full support of the latest features you need to upgrade to a recent version of the SDK.
+See the <<#couchbase-new-feature-availability-matrix,Feature Availablity matrix below>> and the xref:sdk-release-notes.adoc[Release Notes page].
+
 Note the https://www.couchbase.com/support-policy/EOL/[End of Life dates^] for Couchbase Server and SDK versions.
 See the notes there for Support details.
 
@@ -180,35 +180,27 @@ include::{version-common}@sdk:shared:partial$capella.adoc[tag=cloud]
 [.table-merge-cells]
 [cols="7,6,6,6"]
 |===
-| | Server 7.0 & 7.1 | Server 7.2 | Server 7.6
-
-| Enhanced Durability
-3+| All SDK versions
+| | Server 7.2 | Server 7.6  | Server 8.0
 
-| Durable Writes
-3+| Since 3.0
+| KV Range Scan
+| N/A
+2+| All supported SDK versions
 
-| Analytics
-3+| Since 2.7
-
-| Collections
-3+| Since 3.0.6
-
-| Scope-Level {sqlpp} (formerly N1QL) Queries & all Collections features
-3+| Since SDK 3.2.0
-
-| Request Tracing
-3+| Since SDK 3.1.0
+| Vector Search
+| N/A
+2+| From SDK 3.6.0 (base64 encoded vectors from 3.7.0)
 
-| Cloud Native Gateway
-| Not Supported
-2+| From SDK 3.5.0 (with xref:operator::overview.adoc[Couchbase Autonomous Operator] 2.6.1+)
+| Preferred Server Group Replica Reads
+| N/A
+2+| From SDK 3.7.4 (with Server 7.6.2 onwards)
 
-| Vector Search
+| Vector Query using GSI
 2+| N/A
-| From SDK 3.6.0
+| From SDK 3.9.0 ①
 |===
 
+① As part of the standard SDK {sqlpp} API, it should be compatible with all earlier versions of the SDK -- but it has not been tested.
+
 This table is not an exhaustive list -- just a few highlights -- provided to help assess compatibility of older versions in particular.
 For alignment of SDKs and new Server features, scroll down to the information below the <<api-version,API Version table>>.
 
@@ -221,13 +213,13 @@ The following table provides an overview at the time of Java SDK {sdk_dot_minor}
 .Recommended Spring Data Couchbase per Server Version Matrix
 [#table_spring_versions]
 |===
-|  | SDC 5.0 - 5.2 | SDC 5.3 - 5.5
+|  | SDC 5.4 - 5.5 | SDC 6.0
 
 | _Status ->_
 | _Maintenance Support_
 | _New Features, Active Development_
 
-| *Server 7.0 - 8.0*
+| *Server 7.2 - 8.0*
 | *Compatible*
 | *Recommended*
 |===