diff --git a/docs/src/main/asciidoc/datasource.adoc b/docs/src/main/asciidoc/datasource.adoc
index d5afd66cfb894d..94afd7d902598e 100644
--- a/docs/src/main/asciidoc/datasource.adoc
+++ b/docs/src/main/asciidoc/datasource.adoc
@@ -302,6 +302,22 @@ quarkus.datasource.reactive.url=postgresql:///your_database
 quarkus.datasource.reactive.max-size=20
 ----
 
+[WARNING]
+====
+The Reactive Oracle datasource depends on the https://docs.oracle.com/en/database/oracle/oracle-database/23/jjdbc/jdbc-reactive-extensions.html[Reactive Extensions] provided by Oracle in its JDBC driver.
+
+There is a bug in versions 23.2 and 21.11 of the Oracle JDBC driver that prevents from getting any response if:
+
+* Reactive Extensions are used to execute an update/insert query that ends with an error (e.g. constraint violation), and
+* https://vertx.io/docs/vertx-oracle-client/java/#_retrieving_generated_key_values[generated keys retrieval] is enabled.
+
+It is not known yet when the bug will be fixed.
+In the meantime, you can either:
+
+* change the version of the driver in your project to `com.oracle.database.jdbc:ojdbc11:21.10.0.0`, or
+* avoid executing queries with generated keys retrieval (e.g. load sequence value before inserting)
+====
+
 ==== JDBC and reactive datasources simultaneously
 
 When a JDBC extension - along with Agroal - and a reactive datasource extension handling the given database kind are included, they will both be created by default.