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

```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/fetch/issues/806

Received on Friday, 7 September 2018 15:43:32 UTC