diff --git a/README.md b/README.md
index 5ea20557f82..344e4b86a1e 100644
--- a/README.md
+++ b/README.md
@@ -127,7 +127,20 @@ big-endian systems, but _Scylla_ does not officially support these systems.
 If you are upgrading from a previous version of the driver, be sure to have a look at
 the [upgrade guide](/upgrade_guide/).
 
+## Migrating to Java Driver 4.x
 
+Java Driver 3.x is in maintenance mode and receives critical bug fixes only. New projects and
+active development should use [Java Driver 4.x](https://github.com/scylladb/java-driver/tree/scylla-4.x).
+
+The [4.x migration guide](https://java-driver.docs.scylladb.com/stable/upgrade_guide/) covers the
+API changes in detail. The first thing to change is the dependency: the artifacts are renamed, while
+the `com.scylladb` group id stays the same.
+
+| Driver 3.x | Driver 4.x |
+|---|---|
+| `scylla-driver-core` | `java-driver-core`, plus `java-driver-query-builder` if you use the query builder |
+| `scylla-driver-mapping` | `java-driver-mapper-runtime`, plus the `java-driver-mapper-processor` annotation processor |
+| `scylla-driver-extras` | no counterpart; its codecs are either native to 4.x core or covered by its custom-codec support |
 
 ## License
 © DataStax, Inc. 
diff --git a/upgrade_guide/README.md b/upgrade_guide/README.md
index 6a413a7f547..1adaabcf7b2 100644
--- a/upgrade_guide/README.md
+++ b/upgrade_guide/README.md
@@ -3,6 +3,10 @@
 The purpose of this guide is to detail changes made by successive
 versions of the Java driver.
 
+Note that Java Driver 3.x is in maintenance mode and receives critical bug fixes only. If you are
+moving to Java Driver 4.x rather than between 3.x versions, see the
+[4.x migration guide](https://java-driver.docs.scylladb.com/stable/upgrade_guide/) instead.
+
 ### 3.6.0
 
 1.  `ConsistencyLevel.LOCAL_SERIAL.isDCLocal()` now returns true. In driver