[whatwg/streams] A variety of clarity and documentation improvements (#875)

/cc @lgrahl @surma who inspired these changes.

Proofreading and editorial suggestions definitely welcome; this took more work than I anticipated and I'm sure I missed some things.
You can view, comment on, or merge this pull request online at:

  https://github.com/whatwg/streams/pull/875

-- Commit Summary --

  * Fix writable stream writer manual usage example
  * Add a note about our WebSocket-wrapping examples
  * Create dedicated sections for important constructor arguments

-- File Changes --

    M index.bs (513)

-- Patch Links --

https://github.com/whatwg/streams/pull/875.patch
https://github.com/whatwg/streams/pull/875.diff

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/whatwg/streams/pull/875