[whatwg/streams] The link text for creating a new readable stream is awkward. (#1104)

```html
<dfn export for=ReadableStream id=concept-construct-readablestream>construct a <code>ReadableStream</code> object</dfn>
```

The definition reads well, but the usage is weird:

```html
<p>Let <var>stream</var> be the result of
 <a lt="construct a ReadableStream object" for=ReadableStream>constructing</a> a {{ReadableStream}}
 object.
```

Can we change the definition to:

```html
To create <dfn export for=ReadableStream id=concept-construct-readablestream>a new readable stream</dfn>
```

So usage would be:

```html
<p>Let <var>stream</var> be <a>a new readable stream</a>…
```

This makes it similar to [=a new promise=].

-- 
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/issues/1104

Received on Saturday, 30 January 2021 11:10:50 UTC