Skip to content

Conversation

handrews
Copy link
Member

A lot of this content is outdated, unnecessary, or otherwise in need of changing.

  • Be more clear about the OpenAPI vs IANA registries.
  • We do not need to list out all of GitHub's custom media types, and it's better to link to the IANA registry for examples.
  • The RFC for registering media types should be informative, not normative, if we even need it at all.
  • We can merge the Sequential Media Types section into the section on Complete vs Streaming Content, and reorder those sections a bit to read more smoothly.
  • Dump a lot of text that is now better addressed by the "Parsing and Serializing" section under the Schema Object.

A lot of this content is outdated, unnecessary, or otherwise
in need of changing.

* Be more clear about the OpenAPI vs IANA registries.
* We do not need to list out all of GitHub's custom media types,
  and it's better to link to the IANA registry for examples.
* The RFC for registering media types should be informative,
  not normative, if we even need it at all.
* We can merge the Sequential Media Types section into the section
  on Complete vs Streaming Content, and reorder those sections
  a bit to read more smoothly.
* Dump a lot of text that is now better addressed by the
  "Parsing and Serializing" section under the Schema Object.
@handrews handrews added this to the v3.2.0 milestone Aug 31, 2025
@handrews handrews requested review from a team as code owners August 31, 2025 23:27
@handrews handrews added the media and encoding Issues regarding media type support and how to encode data (outside of query/path params) label Aug 31, 2025
@ralfhandl ralfhandl requested a review from a team September 1, 2025 07:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
media and encoding Issues regarding media type support and how to encode data (outside of query/path params)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants