inadarei / rfc-healthcheck

Health Check Response RFC Draft for HTTP APIs

Home Page:https://inadarei.github.io/rfc-healthcheck/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

media type name stability

dret opened this issue · comments

as with the infamous X-... naming patterns for header fields (https://tools.ietf.org/html/rfc6648), the same applies to media types: assigning a name in the draft and then planning to change it is not the best strategy. pick a name you'd like to keep, and then stick to it. otherwise you build fragmentation into the development/adoption process, which makes it harder for people to understand which identifier to use.

@dret, I have already submitted application/vnd.health+json to IANA for registration.

Are you concerned that it is in the vendor branch and not something like application/health+json? I have zero experience applying for non-vendor branch and am quite terrified to even try it. Vendor branch usually takes 1-2month.

I was feeling fine the media type to be application/vnd.health+json forever.

Is that your concern?

great, thanks!