Re: [httpapi] [media-types] YAML media type: requesting early review after WGLC

Hi Paul,

thanks for your email!

On Thu, 6 Oct 2022 at 22:28, Paul Libbrecht <paul@hoplahup.net> wrote:
> I am supposing that YAML content is likely to be exchanged among editors
> using a copy-and-paste exchange mechanism.

Yes.

> If this is the case, I would like to suggest to add uniform type identifiers
> and windows clipboard names so that future implementations may take part to such an exchange
> in the Additional Information section.

Tracked https://github.com/ietf-wg-httpapi/mediatypes/issues/66

I didn't know UTIs and Windows clipboard names:
can you reference any example in IANA registration form?

Is it ok for you to continue the discussion on the github issue?

Have a nice day,
R.

>
> Thanks in advance.
>
> Paul
>
> PS: this might even include web-pages-included editors (an API is arriving).
>
> On 6 Oct 2022, at 10:31, Roberto Polli wrote:
>
> Dear media types folks,
>
> as suggested by Martin Duerst I hereby provide a summary of the media type and structured syntax suffix registrations.
> Thanks again and have a nice day,
> R.
>
> 2.1. Media Type application/yaml
>
> The media type for YAML text is application/yaml; the following information serves as the registration form for this media type.
>
> Type name:
>
> application
>
> Subtype name:
>
> yaml
>
> Required parameters:
>
> N/A
>
> Optional parameters:
>
> N/A; unrecognized parameters should be ignored
>
> Encoding considerations:
>
> binary
>
> Security considerations:
>
> see Section 4 of this document
>
> Interoperability considerations:
>
> see Section 3 of this document
>
> Published specification:
>
> [YAML]
>
> Applications that use this media type:
>
> Applications that need a human-friendly, cross language, Unicode based data serialization language designed around the common native data types of dynamic programming languages.
>
> Fragment identifier considerations:
>
> See Section 1.2
>
> Additional information:
>
> Deprecated alias names for this type: application/x-yaml, text/yaml, text/x-yaml
> Magic number(s) N/A
> File extension(s): yaml, yml
> Macintosh file type code(s): N/A
>
> Person and email address to contact for further information:
>
> See Authors' Addresses section.
>
> Intended usage:
>
> COMMON
>
> Restrictions on usage:
>
> None.
>
> Author:
>
> See Authors' Addresses section.
>
> Change controller:
>
> IESG
>
> 2.2. The +yaml Structured Syntax Suffix
>
> The suffix +yaml MAY be used with any media type whose representation follows that established for application/yaml. The media type structured syntax suffix registration form follows. See [MEDIATYPE] for definitions of each of the registration form headings.
>
> Name:
>
> YAML Ain't Markup Language (YAML)
>
> +suffix:
>
> +yaml
>
> References:
>
> [YAML]
>
> Encoding considerations:
>
> see Section 2.1
>
> Fragment identifier considerations:
>
> Differently from application/yaml, there is no fragment identification syntax defined for +yaml.
>
> A specific xxx/yyy+yaml media type needs to define the syntax and semantics for fragment identifiers because the ones in Section 2.1 do not apply unless explicitly expressed.
>
> Interoperability considerations:
>
> See Section 2.1
>
> Security considerations:
>
> See Section 2.1
>
> Contact:
>
> httpapi@ietf.org or art@ietf.org
>
> Author:
>
> See Authors' Addresses section
>
> Change controller:
>
> IESG
>
>
> On Tue, 4 Oct 2022 at 17:25, Roberto Polli <robipolli@gmail.com> wrote:
>>
>> Dear media types folks,
>>
>> in the HTTPAPI WG are closing the WGLC for YAML media type.
>> The latest I-D is here:
>>
>> - https://www.ietf.org/archive/id/draft-ietf-httpapi-yaml-mediatypes-03.html
>>
>> We'd be grateful if you could provide an early review, so that we can move forward.
>> The publication of this document will allow the registration of xxx+yaml media
>> types, such as:
>>
>> - openapi+yaml which will follow up in the HTTPAPI WG;
>> - ld+yaml which is taking place under the W3C.
>>
>> Thanks for all the support you can provide,
>> and have a nice day,
>> Roberto & the editors
>
> _______________________________________________
> media-types mailing list
> media-types@ietf.org
>
> https://www.ietf.org/mailman/listinfo/media-types