Skip to content

v3.2: Fix the moved Media Types section#4916

Merged
handrews merged 1 commit intoOAI:v3.2-devfrom
handrews:mts
Sep 1, 2025
Merged

v3.2: Fix the moved Media Types section#4916
handrews merged 1 commit intoOAI:v3.2-devfrom
handrews:mts

Conversation

@handrews
Copy link
Copy Markdown
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
Copy link
Copy Markdown
Contributor

@mikekistler mikekistler left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good. 👍

@handrews handrews merged commit 8b999d1 into OAI:v3.2-dev Sep 1, 2025
2 checks passed
@handrews handrews deleted the mts branch September 8, 2025 17:18
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.

3 participants