content icon indicating copy to clipboard operation
content copied to clipboard

Lists in forbidden req/resp header glossary entries should be in HTTP section

Open bsmth opened this issue 6 months ago • 2 comments

MDN URL

https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_request_header

What specific section or headline is this issue about?

No response

What information was incorrect, unhelpful, or incomplete?

The glossary entry has a useful list that is suitable for the HTTP section. We could do with a guide or reference page that describes (lists) these instead of that information living in the glossary.

What did you expect to see?

A new page in HTTP section about forbidden headers:

  • https://fetch.spec.whatwg.org/#forbidden-request-header
  • https://fetch.spec.whatwg.org/#forbidden-response-header-name

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

No response

bsmth avatar Jun 11 '25 15:06 bsmth

There's also:

https://developer.mozilla.org/en-US/docs/Glossary/CORS-safelisted_request_header https://developer.mozilla.org/en-US/docs/Glossary/CORS-safelisted_response_header https://developer.mozilla.org/en-US/docs/Glossary/Request_header https://developer.mozilla.org/en-US/docs/Glossary/Response_header https://developer.mozilla.org/en-US/docs/Glossary/Representation_header https://developer.mozilla.org/en-US/docs/Glossary/Fetch_metadata_request_header https://developer.mozilla.org/en-US/docs/Glossary/General_header (obsolete) https://developer.mozilla.org/en-US/docs/Glossary/Entity_header (obsolete)

We could do with a guide or reference page that describes (lists) these

Question is, where to put it? There is a page at https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers, but it's really just a list of headers. Perhaps we could have a page like "Headers" or "Overview of HTTP headers" under https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides, that describes and lists the types.

I think we should have a separate guide page on Fetch metadata, and I'm sure we could just delete "General header" and "Entity header", couldn't we?

wbamberg avatar Jun 11 '25 22:06 wbamberg

BTW if we are going to do this we should do it before https://github.com/mdn/content/issues/39901, so we don't have so many links to fix up.

wbamberg avatar Jun 11 '25 22:06 wbamberg

This makes sense. I agree that a new guide under /Web/HTTP/Guides like "Overview of HTTP Headers" could be a good home for this. Are we leaning toward that direction? I would be glad to help create or draft the initial version once the placement is confirmed.

Shrinivassab avatar Jun 24 '25 23:06 Shrinivassab

And https://developer.mozilla.org/en-US/docs/Glossary/Content_header.

wbamberg avatar Jun 25 '25 23:06 wbamberg