streams
streams copied to clipboard
whatwg
Early draft of WritableStream "Design Philosophy" section
This is supposed to help implementors and others understand the design principles.
Markup isn't done properly yet, so please evaluate the text only.
@domenic @tyoshino Suggestions, comments, radical changes all welcome.
I uploaded it as a whatwg/streams branch to make it easy to look at the preview, which should show up at https://streams.spec.whatwg.org/branch-snapshots/writable-streams-design-philosophy/ eventually.
I added another item, "Queued calls to writer methods such as write() are not cancelled when writer.releaseLock() is called. This makes them easy to use in a "fire and forget" style." which raises the question of exactly how much detail belongs in this section.
Personally I'm happy with it being quite inclusive, but I don't think it should be an exhaustive list of every design decision we ever made.
Maybe I should rephrase it as "Fire-and-forget style usage is supported. Therefore..."