From 62e0986b83b43e4dbdacd049cc61b19bca0d76dc Mon Sep 17 00:00:00 2001 From: Mikita Hradovich Date: Fri, 5 Jun 2026 16:34:29 +0200 Subject: [PATCH] docs: deprecate Java Driver 3.x and announce maintenance mode Mark Java Driver 3.x as deprecated per DRIVER-854: - Add a deprecation notice to README.md, linking to 4.x - Update the Maven dependency version references to 3.11.5.17 The driver enters maintenance mode with only critical bug fixes. Users should migrate to Java Driver 4.x. No changelog entry: changelog/README.md tracks upstream releases only -- no ScyllaDB release has ever been recorded there -- so a fork-lifecycle notice does not belong in it. Fork releases are documented in GitHub Releases. The docs-site half of the announcement is deliberately not here. The Sphinx site is published from the repository's default branch, so both DEPRECATED_VERSIONS and the deprecation banner only take effect on scylla-4.x; they ship as a companion PR. Co-Authored-By: Claude Opus 5 (1M context) --- README.md | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 5ea20557f82..71419070836 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,18 @@ # Scylla Java Driver for Scylla and Apache Cassandra® +> **Deprecation Notice:** Scylla Java Driver 3.x is now **deprecated** and has +> entered **maintenance mode**. Only critical bug fixes will be accepted. +> For new projects and active development, please migrate to +> [Scylla Java Driver 4.x](https://github.com/scylladb/java-driver/tree/scylla-4.x) +> ([documentation](https://java-driver.docs.scylladb.com/stable/)). + *If you're reading this on github.com, please note that this is the readme for the development version and that some features described here might not yet have been released. You can find the documentation for the latest version through the [Java driver docs](https://docs.scylladb.com/using-scylla/scylla-java-driver/) or via the release tags, [e.g. -3.11.5.0](https://github.com/scylladb/java-driver/releases/tag/3.11.5.0).* +3.11.5.17](https://github.com/scylladb/java-driver/releases/tag/3.11.5.17).* A modern, [feature-rich](manual/) and highly tunable Java client library for Apache Cassandra (2.1+) and using exclusively Cassandra's binary protocol @@ -73,7 +79,7 @@ it in your application using the following Maven dependency com.scylladb scylla-driver-core - 3.11.5.0 + 3.11.5.17 ``` @@ -83,7 +89,7 @@ Note that the object mapper is published as a separate artifact: com.scylladb scylla-driver-mapping - 3.11.5.0 + 3.11.5.17 ``` @@ -93,7 +99,7 @@ The 'extras' module is also published as a separate artifact: com.scylladb scylla-driver-extras - 3.11.5.0 + 3.11.5.17 ``` @@ -107,7 +113,7 @@ by running `dnf -y install libxcrypt-compat` ## Compatibility -The Java client driver 3.11.5.0 ([branch scylla-3.x](https://github.com/scylladb/java-driver/tree/scylla-3.x)) is compatible with +The Java client driver 3.11.5.17 ([branch scylla-3.x](https://github.com/scylladb/java-driver/tree/scylla-3.x)) is compatible with Scylla and Apache Cassandra 2.1, 2.2, 3.0+. UDT and tuple support is available only when using Apache Cassandra 2.1 or higher.