add comments about server/client weirdness

Author: capaj

src/content/docs/workers/examples/websockets.mdx

@@ -94,8 +94,8 @@ async function handleRequest(request) {
   }
 
   const webSocketPair = new WebSocketPair();
-  const client = webSocketPair[0],
-    server = webSocketPair[1];
+  const client = webSocketPair[0], // server-side WS endpoint in the worker
+    server = webSocketPair[1]; // this is the remote from whoever connected to your worker-a browser client for example
 
   return new Response(null, {
     status: 101,
@@ -118,8 +118,8 @@ async fn fetch(req: HttpRequest, _env: Env, _ctx: Context) -> Result<worker::Res
     }
 
     let ws = WebSocketPair::new()?;
-    let client = ws.client;
-    let server = ws.server;
+    let client = ws.client;  // server-side WS endpoint in the worker
+    let server = ws.server; // this is the remote from whoever connected to your worker-a browser client for example
     server.accept()?;
 
     worker::Response::from_websocket(client)
@@ -300,4 +300,4 @@ async function websocket(url) {
 
 ## WebSocket compression
 
-Cloudflare Workers supports WebSocket compression. Refer to [WebSocket Compression](/workers/configuration/compatibility-flags/#websocket-compression) for more information.
+Cloudflare Workers supports WebSocket compression. Refer to [WebSocket Compression](/workers/configuration/compatibility-flags/#websocket-compression) for more information.