WebSockets Next: clarify connector API docs/javadoc #1835

Job	Run time
CI Sanity Check	31s
Attach pull request number	0s
Initial JDK 17 Build	14m 39s
Calculate Test Jobs	9s
JVM Tests - JDK 17	7m 8s
JVM Tests - JDK 21	8m 8s
JVM Tests - JDK 17 Windows	12m 22s
Gradle Tests - JDK ${{ matrix.java.name }}	0s
Devtools Tests - JDK ${{ matrix.java.name }}	0s
Kubernetes Tests - JDK ${{ matrix.java.name }}	0s
Maven Tests - JDK ${{ matrix.java.name }}	0s
Quickstarts Compilation - JDK 17	6m 11s
Native Tests - HTTP	5m 41s
MicroProfile TCKs Tests	0s
Native Tests - Virtual Thread - ${{ matrix.category }}	0s
Upload build stats to collector	0s
Build report	44s
	55m 33s

Provide feedback