diff --git a/index.bs b/index.bs
index 1082cab2a..9850776d7 100644
--- a/index.bs
+++ b/index.bs
@@ -4964,6 +4964,21 @@ writable stream:
.catch(e => console.error("Something went wrong!", e));
+
+ This specific style of wrapping a web socket interprets web socket messages directly as
chunks.
+ This can be a convenient abstraction, for example when
piping to a
writable stream or
transform
+ stream for which each web socket message makes sense as a chunk to consume or transform.
+
+ However, often when people talk about "adding streams support to web sockets", they are hoping instead for a new
+ capability to send an individual web socket message in a streaming fashion, so that e.g. a file could be transferred
+ in a single message without holding all of its contents in memory on the client side. To accomplish this goal, we'd
+ instead want to allow individual web socket messages to themselves be {{ReadableStream}} instances. That isn't what we
+ show in the above example.
+
+ For more background, see
this
+ discussion.
+
+