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/




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).


_______________________________________________
IETF-Announce mailing list
IETF-Announce@ietf.org
https://www.ietf.org/mailman/listinfo/ietf-announce

Reply via email to