diff --git a/jetty-websocket/websocket-api/src/main/java/org/eclipse/jetty/websocket/api/RemoteEndpoint.java b/jetty-websocket/websocket-api/src/main/java/org/eclipse/jetty/websocket/api/RemoteEndpoint.java
index 37dcec929481..0b13c57fa3a0 100644
--- a/jetty-websocket/websocket-api/src/main/java/org/eclipse/jetty/websocket/api/RemoteEndpoint.java
+++ b/jetty-websocket/websocket-api/src/main/java/org/eclipse/jetty/websocket/api/RemoteEndpoint.java
@@ -144,7 +144,9 @@ public interface RemoteEndpoint
     /**
      * Set the maximum number of frames which allowed to be waiting to be sent at any one time.
      * The default value is -1, this indicates there is no limit on how many frames can be
-     * queued to be sent by the implementation.
+     * queued to be sent by the implementation. If the limit is exceeded, subsequent frames
+     * sent are failed with a {@link java.nio.channels.WritePendingException} but
+     * the connection is not failed and will remain open.
      *
      * @param maxOutgoingFrames the max number of frames.
      */
@@ -153,7 +155,9 @@ public interface RemoteEndpoint
     /**
      * Get the maximum number of frames which allowed to be waiting to be sent at any one time.
      * The default value is -1, this indicates there is no limit on how many frames can be
-     * queued to be sent by the implementation.
+     * queued to be sent by the implementation. If the limit is exceeded, subsequent frames
+     * sent are failed with a {@link java.nio.channels.WritePendingException} but
+     * the connection is not failed and will remain open.
      *
      * @return the max number of frames.
      */