diff --git a/docs/modules/hive/partials/supported-versions.adoc b/docs/modules/hive/partials/supported-versions.adoc
index e199808b..e21a9ba6 100644
--- a/docs/modules/hive/partials/supported-versions.adoc
+++ b/docs/modules/hive/partials/supported-versions.adoc
@@ -2,17 +2,19 @@
 // This is a separate file, since it is used by both the direct Hive-Operator documentation, and the overarching
 // Stackable Platform documentation.
 
-- 4.0.1 (experimental)
-- 4.0.0 (LTS)
+- 4.0.1 (LTS)
+- 4.0.0 (deprecated)
 - 3.1.3 (deprecated)
 
 === Hive 4 issues
 
-As of SDP 25.7, Hive 4 is still relatively new and there are some known issues, especially when using it with Iceberg and Trino.
-The missing comppatibilty with Iceberg also means that Spark jobs using this storage may fail.
+Hive 4 has known compatibility issues, especially when using it with Iceberg or Trino.
+The missing compatibility with Iceberg also means that Spark jobs using this storage may fail.
+
+**Workaround:** If you encounter issues with Hive 4, use Hive 3.1.3 instead until these upstream issues are resolved.
 
 For more details, see:
 
-* https://github.com/stackabletech/hive-operator/issues/626[The stackable tracking issue]
-* https://github.com/trinodb/trino/issues/26214[Trino issue]
-* https://github.com/apache/iceberg/issues/12878[Spark with Iceberg issue]
+* https://github.com/stackabletech/hive-operator/issues/626[Our Stackable tracking issue]
+* https://github.com/trinodb/trino/issues/26214[Trino: Repeated ANALYZE fails on Hive metastore 4.0.x]
+* https://github.com/apache/iceberg/issues/12878[Iceberg: org.apache.thrift.TApplicationException: Invalid method name: 'get_table']