Re: [whatwg/streams] Standard text for TransformStream (#811)

I reviewed the comments in the reference implementation to see if any would be useful as notes in the standard. I added a couple more notes. To be honest, I feel that inline notes can make the algorithm harder to follow. It would be nice to have a separate non-normative "algorithm overview" section where we explain how it works. But we don't have anything like that for ReadableStream and WritableStream (and it might be prohibitively complicated to have an up-to-date explanation for those).

Anyway, I believe that implementers will find out how it works in the process of implementing it. Ordinary web developers don't need to know why it works. The mental model of "transform is called when there is no backpressure" is super-easy to understand and the subtleties involved in delivering that are not their problem.

-- 
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/811#issuecomment-339995642