Re: [httpapi] RFC 9512 on YAML Media Type

[Roberto Polli <[e-mail]>]

Hi Orie.

On Mon, 19 Feb 2024 at 15:11, Orie Steele <[e-mail]> wrote:
> Congratulations to all involved.

Thanks :)

> I've seen the structured suffix already being used here:
>
> https://www.w3.org/community/reports/json-ld/CG-FINAL-yaml-ld-20231206/#application-ld-yaml
>
Yes, the YAML-ld concept started under the IETF but was then delegated
to the json-ld wg.

> Not sure if I am interpreting the API media type comment correctly... Is there a plan to do
>
> application/schema+json
We're working on it. See https://github.com/ietf-wg-httpapi/mediatypes/issues


> application/schema+yaml
While I think it's key, we should first finish schema+json


> In a single document?

Can you please clarify what does "single document" mean?
A document should be either YAML or JSON.
You can use YAML "flow collection style", in order to create
JSON-like YAML. See https://www.rfc-editor.org/rfc/rfc9512.html#section-3.4
Still, the content will be either JSON or YAML.

Thanks again for your kind words,
R.


> On Mon, Feb 19, 2024 at 3:35 AM Roberto Polli <[e-mail]> wrote:
>>
>> Hi Darrel + Rich,
>>
>> On Mon, 19 Feb 2024 at 04:48, Darrel Miller <[e-mail]> wrote:
>> > Congratulations to Roberto, Erik and Eemeli on getting over the finish line with RFC 9512.  It was great to see the deep thinking that went into getting this document as clear and as comprehensive as possible.  I am confident that the time spent on getting this document right will save many people from frustration in the future.
>>
>> Thanks to you  Rich and all the wonderful IETF, YAML, OAS and
>> JSONSCHEMA communities that make it happen.
>>
>> The road to API mediatype standardization is still long, though :D
>>
>> Have a nice day,
>> R.
>>
>>
>> > ________________________________
>> > From: httpapi <[e-mail]> on behalf of [e-mail] <[e-mail]>
>> > Sent: Wednesday, February 14, 2024 5:01 PM
>> > To: [e-mail] <[e-mail]>; [e-mail] <[e-mail]>
>> > Cc: [e-mail] <[e-mail]>; [e-mail] <[e-mail]>; [e-mail] <[e-mail]>
>> > Subject: [httpapi] RFC 9512 on YAML Media Type
>> >
>> > A new Request for Comments is now available in online RFC libraries.
>> >
>> >
>> >         RFC 9512
>> >
>> >         Title:      YAML Media Type
>> >         Author:     R. Polli,
>> >                     E. Wilde,
>> >                     E. Aro
>> >         Status:     Informational
>> >         Stream:     IETF
>> >         Date:       February 2024
>> >         Mailbox:    [e-mail],
>> >                     [e-mail],
>> >                     [e-mail]
>> >         Pages:      13
>> >         Updates/Obsoletes/SeeAlso:   None
>> >
>> >         I-D Tag:    draft-ietf-httpapi-yaml-mediatypes-10.txt
>> >
>> >         URL:        https://www.rfc-editor.org/info/rfc9512
>> >
>> >         DOI:        10.17487/RFC9512
>> >
>> > This document registers the application/yaml media type and the +yaml
>> > structured syntax suffix with IANA.  Both identify document
>> > components that are serialized according to the YAML specification.
>> >
>> > This document is a product of the Building Blocks for HTTP APIs Working Group of the IETF.
>> >
>> >
>> > INFORMATIONAL: This memo provides information for the Internet community.
>> > It does not specify an Internet standard of any kind. Distribution of
>> > this memo is unlimited.
>> >
>> > This announcement is sent to the IETF-Announce and rfc-dist lists.
>> > To subscribe or unsubscribe, see
>> >   https://www.ietf.org/mailman/listinfo/ietf-announce
>> >   https://mailman.rfc-editor.org/mailman/listinfo/rfc-dist
>> >
>> > For searching the RFC series, see https://www.rfc-editor.org/search
>> > For downloading RFCs, see https://www.rfc-editor.org/retrieve/bulk
>> >
>> > Requests for special distribution should be addressed to either the
>> > author of the RFC in question, or to [e-mail].  Unless
>> > specifically noted otherwise on the RFC itself, all RFCs are for
>> > unlimited distribution.
>> >
>> >
>> > The RFC Editor Team
>> > Association Management Solutions, LLC
>> >
>> >
>> > --
>> > httpapi mailing list
>> > [e-mail]
>> > https://www.ietf.org/mailman/listinfo/httpapi
>>
>> --
>> httpapi mailing list
>> [e-mail]
>> https://www.ietf.org/mailman/listinfo/httpapi
>
>
>
> --
>
>
> ORIE STEELE
> Chief Technology Officer
> www.transmute.industries
>
>