YAML Media Type
draft-ietf-httpapi-yaml-mediatypes-10

Approval announcement
Draft of message to be sent after approval:

Announcement

From: The IESG <iesg-secretary@ietf.org>
To: IETF-Announce <ietf-announce@ietf.org>
Cc: The IESG <iesg@ietf.org>, darrel@tavis.ca, draft-ietf-httpapi-yaml-mediatypes@ietf.org, httpapi-chairs@ietf.org, httpapi@ietf.org, rfc-editor@rfc-editor.org, zahed.sarker.ietf@gmail.com
Subject: Document Action: 'YAML Media Type' to Informational RFC (draft-ietf-httpapi-yaml-mediatypes-07.txt)

The IESG has approved the following document:
- 'YAML Media Type'
  (draft-ietf-httpapi-yaml-mediatypes-07.txt) as Informational RFC

This document is the product of the Building Blocks for HTTP APIs Working
Group.

The IESG contact persons are Zaheduzzaman Sarker, Murray Kucherawy and
Francesca Palombini.

A URL of this Internet-Draft is:
https://datatracker.ietf.org/doc/draft-ietf-httpapi-yaml-mediatypes/

Ballot Text

Technical Summary

This document registers the application/yaml media type and the +yaml structured syntax suffix on the IANA Media Types registry, intended to be used to identify document components serialized according to the YAML specification.

Working Group Summary

There has been some concern raised over the +yaml suffix being registered in
the document and how it might impact the ongoing work here
in the MEDIAMAN working group with regard to fragment
identifiers.  However, that issue was closed at IETF115 with the recognition
that each registered suffix is explicit in saying what fragment identifier
should be used. https://github.com/ietf-wg-mediaman/suffixes/issues/3

Due to compatibility challenges with the fragment identifier syntax defined for
application/yaml and some of the candidate mediatypes that are looking to adopt
the +yaml suffix, it was decided to defer the definition of the +yaml fragment
identifier to any future mediatype registration that adopts the +yaml suffix. 
This issue took some work to reach consensus, but did in the end
https://github.com/ietf-wg-httpapi/mediatypes/issues/50.

Document Quality

There are implementations that assume `application/yaml` is already a
registered media type.  Seaching GitHub finds more than 43K files using the
media type name and more than 5K files using `+yaml` suffix.

Participants in the mediaman working group have been involved in reviewing this
content.  Developers of yaml parsers have been involved.  Several members of
the JSON Schema community have provided feedback as well as members of the
OpenAPI community.

Personnel

The Document Shepherd for this document is Darrel Miller. The
Responsible Area Director is Francesca Palombini (stand in AD Zaheduzzaman Sarker).

RFC Editor Note