diff --git a/jOOQ/src/main/java/org/jooq/DSLContext.java b/jOOQ/src/main/java/org/jooq/DSLContext.java
index bc7a50c52f..43d0625cf2 100644
--- a/jOOQ/src/main/java/org/jooq/DSLContext.java
+++ b/jOOQ/src/main/java/org/jooq/DSLContext.java
@@ -198,7 +198,11 @@ public interface DSLContext extends Scope , AutoCloseable  {
      * has been obtained from {@link ConnectionProvider#acquire()} and must be
      * released by calling {@link Connection#close()}.
      * <p>
-     * This is experimental functionality.
+     * This is experimental functionality. While this works well for static
+     * {@link Statement} executions, bind variables and their position
+     * calculation might cause issues when the generated SQL output involves
+     * more complex SQL transformation. See also <a href=
+     * "https://github.com/jOOQ/jOOQ/issues/5759">https://github.com/jOOQ/jOOQ/issues/5759</a>.
      */
     Connection parsingConnection();