diff --git a/jetty-io/src/main/java/org/eclipse/jetty/io/ArrayByteBufferPool.java b/jetty-io/src/main/java/org/eclipse/jetty/io/ArrayByteBufferPool.java
index 02a6130c9aee..2808f26eef82 100644
--- a/jetty-io/src/main/java/org/eclipse/jetty/io/ArrayByteBufferPool.java
+++ b/jetty-io/src/main/java/org/eclipse/jetty/io/ArrayByteBufferPool.java
@@ -34,7 +34,7 @@
  * <p>Given a capacity {@code factor} of 1024, the first array element holds a queue of ByteBuffers
  * each of capacity 1024, the second array element holds a queue of ByteBuffers each of capacity
  * 2048, and so on.</p>
- * The {@code maxHeapMemory} and {@code maxDirectMemory} default heuristic is to use {@link Runtime#maxMemory()}
+ * <p>The {@code maxHeapMemory} and {@code maxDirectMemory} default heuristic is to use {@link Runtime#maxMemory()}
  * divided by 4.</p>
  */
 @ManagedObject
diff --git a/jetty-io/src/main/java/org/eclipse/jetty/io/ArrayRetainableByteBufferPool.java b/jetty-io/src/main/java/org/eclipse/jetty/io/ArrayRetainableByteBufferPool.java
index cf4c0e239bf4..b406e7338251 100644
--- a/jetty-io/src/main/java/org/eclipse/jetty/io/ArrayRetainableByteBufferPool.java
+++ b/jetty-io/src/main/java/org/eclipse/jetty/io/ArrayRetainableByteBufferPool.java
@@ -36,7 +36,7 @@
  * <p>Given a capacity {@code factor} of 1024, the first array element holds a Pool of RetainableByteBuffers
  * each of capacity 1024, the second array element holds a Pool of RetainableByteBuffers each of capacity
  * 2048, and so on.</p>
- * The {@code maxHeapMemory} and {@code maxDirectMemory} default heuristic is to use {@link Runtime#maxMemory()}
+ * <p>The {@code maxHeapMemory} and {@code maxDirectMemory} default heuristic is to use {@link Runtime#maxMemory()}
  * divided by 4.</p>
  */
 @ManagedObject
diff --git a/jetty-io/src/main/java/org/eclipse/jetty/io/ClientConnector.java b/jetty-io/src/main/java/org/eclipse/jetty/io/ClientConnector.java
index a58277262153..1129e7bc6816 100644
--- a/jetty-io/src/main/java/org/eclipse/jetty/io/ClientConnector.java
+++ b/jetty-io/src/main/java/org/eclipse/jetty/io/ClientConnector.java
@@ -624,6 +624,7 @@ public boolean isIntrinsicallySecure(ClientConnector clientConnector, SocketAddr
          * {@link SocketChannel#connect(SocketAddress)}, as this is done later,
          * after configuring the socket, by the {@link ClientConnector} implementation.</p>
          *
+         * @param clientConnector the client connector requesting channel with associated address
          * @param address the destination socket address, typically specified in a URI
          * @param context the context to create the new socket channel
          * @return a new {@link SocketChannel} with an associated {@link SocketAddress} to connect to
diff --git a/jetty-io/src/main/java/org/eclipse/jetty/io/WriteFlusher.java b/jetty-io/src/main/java/org/eclipse/jetty/io/WriteFlusher.java
index b4d5319dca1e..92fdad780955 100644
--- a/jetty-io/src/main/java/org/eclipse/jetty/io/WriteFlusher.java
+++ b/jetty-io/src/main/java/org/eclipse/jetty/io/WriteFlusher.java
@@ -408,6 +408,7 @@ public void completeWrite()
     /**
      * Flushes the buffers iteratively until no progress is made.
      *
+     * @param address the datagram channel to send the buffers to (used by QUIC and HTTP/3)
      * @param buffers The buffers to flush
      * @return The unflushed buffers, or null if all flushed
      * @throws IOException if unable to flush