feat(http): Update some mentions of "payload" -> "content"

[bsmth]

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_Content
• Payload_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:

• Update the simple RFC 7231 refs to use RFC 9110 #20743
• feat(http): Replace usage of "payload" with "content" #35063

[github-actions]

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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 URL
  • External image URL
  • External image URL
  • External 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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 exist
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
  • Wrong 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)

[bsmth]

@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! 🙏🏻

[hamishwillee]

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.

[bsmth]

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.

[hamishwillee]

Thanks very much @bsmth - LGTM.