search

whatwg / xhr

XMLHttpRequest Standard
https://xhr.spec.whatwg.org/
Other
314 stars 129 forks source link

Editorial: Use the term "author request headers" consistently #354

Closed berniegp closed 1 year ago

berniegp commented 2 years ago

The spec uses the term "author request headers" everywhere except in the description of the OPENED state in https://xhr.spec.whatwg.org/#states. This commit fixes this inconsistency.

I think this qualifies as an Editorial change, but I am unsure. Please advise is this is incorrect.

(See WHATWG Working Mode: Changes for more details.)

Preview | Diff

annevk commented 2 years ago

I think this is actually fine and instead we should reword

Combines a header in author request headers.

to something like:

Appends a value to an existing request header or adds a new request header.

"author request headers" is an internal field of XMLHttpRequest instances and there's no need to talk about it in informative text.

berniegp commented 2 years ago

I wasn't aware of the possible distinct treatment of informative text. In that case, I agree that your suggestion is much clearer than talking about "author" request headers.