[whatwg/streams] Editorial: Define "create a ReadableStream" instead of just "create" (#1078)

The current definition forces redundant text in callers:

```
... the result of [=ReadableStream/creating=] a {{ReadableStream}} given ...
```

My proposal allows just

```
... the result of [=creating a ReadableStream=] given ...
```

The general principle is that `for` works well for methods of an existing object, where readers will see the object with its type at any call site. We shouldn't use `for` in creation methods where there's no other object of the `for` type at the call site.

This change will, unfortunately, break existing calls to this algorithm. I think we could add an empty `<dfn export for=ReadableStream lt="create|creating"></dfn>` before it to keep those working if you want.
You can view, comment on, or merge this pull request online at:

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

-- Commit Summary --

  * Define "create a ReadableStream" instead of just "create"

-- File Changes --

    M index.bs (2)

-- Patch Links --

https://github.com/whatwg/streams/pull/1078.patch
https://github.com/whatwg/streams/pull/1078.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/1078