content
content copied to clipboard
mdn
feat(http): Update some mentions of "payload" -> "content"
Description
Replaces #35063 because of git hijinks. This is a maintenance PR part of work to refresh HTTP docs.
Fixes #20741 which looks like a simple change, but it's trickier because we have to be more abstract to encompass HTTP/1.1 -> HTTP/3 concepts.
Changes:
Payload_body->HTTP_ContentPayload_header->Content_header- Contextual update to:
- Transfer encoding
- Content encoding
- 413 status err
- Other instances of "payload" -> "content" where it makes sense, not everywhere.
Motivation
Keeping content up-to-date and useful.
Related issues and pull requests:
- [x] https://github.com/mdn/content/pull/20743
- [x] https://github.com/mdn/content/pull/35063
Preview URLs (19 pages)
/en-US/docs/Glossary/Content_header/en-US/docs/Glossary/Entity_header/en-US/docs/Glossary/HTTP_Content/en-US/docs/Glossary/Representation_header/en-US/docs/Web/HTTP/CORS/en-US/docs/Web/HTTP/Headers/Content-Encoding/en-US/docs/Web/HTTP/Headers/Content-Length/en-US/docs/Web/HTTP/Headers/Content-Range/en-US/docs/Web/HTTP/Headers/Trailer/en-US/docs/Web/HTTP/Headers/Transfer-Encoding/en-US/docs/Web/HTTP/Messages/en-US/docs/Web/HTTP/Methods/GET/en-US/docs/Web/HTTP/Methods/PATCH/en-US/docs/Web/HTTP/Methods/PUT/en-US/docs/Web/HTTP/Methods/en-US/docs/Web/HTTP/Network_Error_Logging/en-US/docs/Web/HTTP/Status/400/en-US/docs/Web/HTTP/Status/415/en-US/docs/Web/HTTP/Status/417
Flaws (49)
Note! 4 documents with no flaws that don't need to be listed. 🎉
URL: /en-US/docs/Web/HTTP/Methods
Title: HTTP request methods
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
URL: /en-US/docs/Web/HTTP/Methods/PATCH
Title: PATCH
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
URL: /en-US/docs/Web/HTTP/Methods/PUT
Title: PUT
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
URL: /en-US/docs/Web/HTTP/Methods/GET
Title: GET
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
URL: /en-US/docs/Web/HTTP/Network_Error_Logging
Title: Network Error Logging
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
URL: /en-US/docs/Web/HTTP/CORS
Title: Cross-Origin Resource Sharing (CORS)
Flaw count: 7
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
- images:
External image URLExternal image URLExternal image URLExternal image URL
URL: /en-US/docs/Web/HTTP/Headers/Trailer
Title: Trailer
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
URL: /en-US/docs/Web/HTTP/Headers/Transfer-Encoding
Title: Transfer-Encoding
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
URL: /en-US/docs/Web/HTTP/Headers/Content-Range
Title: Content-Range
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
URL: /en-US/docs/Web/HTTP/Headers/Content-Length
Title: Content-Length
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
URL: /en-US/docs/Web/HTTP/Headers/Content-Encoding
Title: Content-Encoding
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
URL: /en-US/docs/Web/HTTP/Messages
Title: HTTP Messages
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
URL: /en-US/docs/Web/HTTP/Status/417
Title: 417 Expectation Failed
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
URL: /en-US/docs/Web/HTTP/Status/400
Title: 400 Bad Request
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
URL: /en-US/docs/Web/HTTP/Status/415
Title: 415 Unsupported Media Type
Flaw count: 3
- macros:
/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web does not existWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLsWrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs
External URLs (4)
URL: /en-US/docs/Glossary/Content_header
Title: Content header
- https://datatracker.ietf.org/doc/html/rfc7231 (2 times) (Note! This may be a new URL 👀)
- https://httpwg.org/specs/rfc9110.html (2 times) (Note! This may be a new URL 👀)
URL: /en-US/docs/Glossary/HTTP_Content
Title: HTTP Content
- https://datatracker.ietf.org/doc/html/rfc7231 (1 time) (Note! This may be a new URL 👀)
- https://httpwg.org/specs/rfc9110.html (2 times) (Note! This may be a new URL 👀)
(comment last updated: 2024-08-28 09:34:25)
![github-actions[bot] avatar](https://avatars.githubusercontent.com/in/15368?v=4 "Published by a pub.dev verified publisher"){kind=small}
@hamishwillee the other PR was... trashed from merge conflicts and git hijinks. I incorporated all of your comments, with some other clarifications that I hope make it clearer.
Because we don't see "content headers" defined in later specs, I'm not sure how useful this page is, but at least we shouldn't really be talking about "payload headers" anymore. No rush on this, btw! 🙏🏻
I think I was perhaps a bit picky but I found this very hard to review - mostly because until I got near the end I was still unclear on exactly how content and representation headers differ. Now I know :-) Thank you.
I think I was perhaps a bit picky but I found this very hard to review - mostly because until I got near the end I was still unclear on exactly how content and representation headers differ. Now I know :-) Thank you.
Thanks Hamish! It becomes clearer why "payload headers" are dropped in later RFCs and we're left with "representation headers" for metadata, then everything else is either a request or a response header. I think that's less confusing.