WebSockets Next: clarify connector API docs/javadoc #47001

Job	Run time
Attach pull request number	2s
CI Sanity Check	31s
Initial JDK 17 Build	14m 30s
Calculate Test Jobs	10s
JVM Tests - JDK 17	8m 2s
JVM Tests - JDK 21	9m 30s
Gradle Tests - JDK ${{ matrix.java.name }}	0s
Maven Tests - JDK ${{ matrix.java.name }}	0s
Quickstarts Compilation - JDK 17	6m 21s
JVM Tests - JDK 17 Windows	12m 54s
Devtools Tests - JDK ${{ matrix.java.name }}	0s
Kubernetes Tests - JDK ${{ matrix.java.name }}	0s
Native Tests - Virtual Thread - ${{ matrix.category }}	0s
MicroProfile TCKs Tests	0s
Native Tests - HTTP	4m 37s
Upload build stats to collector	0s
Build report	38s
	57m 15s

Provide feedback