Re: [whatwg/fetch] Add domintro explanations for web developers (#543)

I think even the Events section in DOM leaves a bit to be desired due to how Bikeshed works.

> `<dt><code><var>event</var> . {{Event/target}}</code>`

would be better as

> `<dt><code><var>event</var> . <a attribute for=Event>target</a></code>`

to avoid the nested `<code>`, but generally it indeed looks fine. (Also, not applicable to Events necessarily, if you need multiple paragraphs in any of the `<dd>` it's better they all have at least one `<p>` inside them.)

Another thing to note is that these do not need to be as detailed as the corresponding normative description. Many details can be left out. We just want to convey the high-level idea and the common usage pattern.

-- 
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/543#issuecomment-302640139