-
Notifications
You must be signed in to change notification settings - Fork 97
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Revisit Verifiable Credential media types #1462
Comments
Summary of the meeting at IETF 119 for those that were not in attendance: This all started about a decade ago with JSON-LD. We wanted to register "application/json-ld" for the media type. IETF's Media Types group feedback was effectively: "Well, what you have is a media type encoded in JSON, so you should choose something with a "+json" at the end of it. The JSON-LD WG at the time said: "Ok, that's weird, but we'll do that, and selected Later, when the W3C DID WG was under way, the group went: "Ok, based on IETF's guidance on suffixes, one serialization of this At that point, the DID WG was asked to justify the usage of multiple structured suffixes, which were allowed, but not thought through cleanly when media type suffixes were introduced at IETF -- that was 5 years ago, it's taken 3 of those years to write up the rules on how to interpret multiple suffixes such that no one would object to what was written up. We have now done this, reducing the open issue count on the spec down to zero, but new ones keep being raised (at the last minute during the IETF meetings) because a few people continue to feel "uneasy" about suffixes... and it seems like this is because there is a contingent of people at IETF that feel that suffixes were a bad idea to begin with, except that there are now multiple media types that use suffixes at IETF. The latest set of suggestions are to:
At this point, the time it will take IETF to come to a conclusion on this has an unbounded time horizon. It might take one more meeting, or it might take many more years for IETF to figure out if they want to keep suffixes or not, and the VCWG cannot be coupled to a timeline like that. Gory details (video recording of the meeting): https://youtu.be/xEGSm6oN7gw?si=DBpVIhmbVXK78j6j&t=600 |
There are a few paths forward that we could take: Option A: Take the ExceptionIETF Media Types registration process would treat us as an "exceptional case" and grandfather Pros:
Cons:
Option B: Use No SuffixesWe could just register Pros:
Cons:
Option C: Stay the CourseWe could take a strong position in favor of multiple structured suffixes at IETF, use this as a use case for the need for multiple structured suffixes, help them figure out the language around suffixes and multiple structured suffixes, and stay the course. Pros:
Cons:
|
I'd be in favor of Option A + Option C. 😃 As in, we need to be able to move forward and because multiple structured suffixes are a perennial request from many communities across the Web, we need to make sure this work at the IETF heads in an enabling direction and reaches the finish line. |
Chair hat firmly off, I am a strong proponent of option B.
Chair hat back on, I would like the conversation to develop here and then
in a couple of weeks we can have a discussion during a WG call.
…On Mon, Mar 25, 2024 at 11:27 AM BigBlueHat ***@***.***> wrote:
I'd be in favor of Option A + Option C. 😃 As in, we need to be able to
move forward and because multiple structured suffixes are a perennial
request from many communities across the Web, we need to make sure this
work at the IETF heads in an enabling direction *and* reaches the finish
line.
—
Reply to this email directly, view it on GitHub
<#1462 (comment)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/ACPFKP7EU4RM7IQ2CZ3K4TLY2BNBZAVCNFSM6AAAAABFCXNGN2VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDAMJYGUZDQNRQGQ>
.
You are receiving this because you authored the thread.Message ID:
***@***.***>
|
For vc-jose-cose, even if we register applicaiton/vc for use as the "cty" value, I believe we'd still want to use application/vc+jwt, application/vc+sd-jwt, and application/vc+cose for the "typ" values. |
It's clear to me that suffixes make sense to express sub-syntaxes (of increasing specificity) of a super syntax. I tend to offer this sub-class analogy for how I think of it:
In this case, a square is a more specific type of rectangle and a rectangle is a more specific type of shape. In this same way, you could define the expression of an Animal in XML -- and add more specific characteristics for a specific Animal, say, a Dog:
I think this is the useful way to use suffixes -- and that "The Right Thing To Do" is to say that this is the main use case for multiple suffixes and a good use of the feature. I'd say that we should either not speak to other use cases or discourage them (at least for now). I personally would have probably expressed the sub-classes in reverse order, but that's water under the bridge. However, it does not seem to me that there's consensus on this understanding of multiple suffixes and I don't know if we can get there with little effort. There are other people looking to use (or are already using) suffixes as a mechanism to express ("smuggle" in?) media type information about the content of envelopes or compression-style archive formats into a single media type (i.e., This problem does not exist when one is just expressing a sub-syntax of another syntax as a single, more specific media type that can then be consumed by broader applications (e.g., editors of Shapes/XML) and increasingly more specific ones (Rectangle/XML Animal consumers) or (Square/XML Dog consumers). I think there is significant utility in being able to express sub-syntaxes in this way with few drawbacks. However, if we're not able to get to consensus on doing it, it's not the end of the world, it's just a shame that will probably generate more work and might slow innovation in various directions. That's an acceptable outcome, but not ideal. If there is significant push back on this approach, I think choosing Option A or B is the way to go with B being an unfortunate, but acceptable compromise to move things along. |
The issue was discussed in a meeting on 2024-03-27
View the transcript2.2. Revisit media types (issue vc-data-model#1462)See github issue vc-data-model#1462. Manu Sporny: mediaType for DM does not have a consensus yet. Brent Zundel: multiple suffixes draft means that the authors did not describe single suffix properly. |
The issue was discussed in a meeting on 2024-03-27
View the transcript3.5. Revisit media types (issue vc-data-model#1462)See github issue vc-data-model#1462. Manu Sporny: can we highlight the options now please.
Manu Sporny: 2) application/vc. Ivan Herman: a variation of 2 or 3 is to put a statement into the new charter saying that we will do the mediaType after the IETF has finished.
|
@mnot @martinthomson please take a look at #1462 (comment) , which goes some way towards providing what could become text regarding "What makes a good suffix? What makes a bad suffix?" in the multiple suffixes draft at IETF. Would text along those lines address some/all of your concerns? Or is there additional guidance we'd need to provide? |
Can we pick not use this venue for the discussion? We also have https://github.com/ietf-wg-mediaman/suffixes and mediaman@ietf.org. I think that @dlongley's comment is constructive, but I don't want to fracture the discussion between venues. |
(This opinion is mine, with my W3C staff contact's hat put down.) I agree with @martinthomson: this issue is not the right place to have a discussion on the merits (or not) of multiple suffixes. The problem we have to decide on is: what should the WG do with the VC spec. As (most of) the rec-track specifications are in CR right now, it seems that we should not have a dependency on the IETF discussions; this would delay the timely completion of the WG's work. Looking at the alternatives in #1462 (comment), outlined by @msporny, option "B" is the most optimal as far as I am concerned. Version 1.1 of VC could be deployed without the introduction of multiple suffixes; we can do the same with Version 2.0. Also, as I said on the call, we can come back to this issue in future releases in case the IETF discussion eventually conclude in favour of multiple suffixes; we may want to add a note on that into the new, proposed charter of the WG to make it clear. Also... I know it is not popular, it is not handy, etc., but we could register some profiles for the |
I prefer options A and C since as @dlongley said, there are sensible reasons for having multiple suffixes. |
... except that their meaning is not specified by any existing standard (yet?). I do not think we can publish a Rec with it, unless we put our document on hold, hoping that IETF gives a green light to it. |
I support option B. Possibly with a redundant entry for: application/ld+json with a profile, as is supported in activity pub today. |
I prefer A+C mixed (not B). @dlongley -- I'm still digging through the suffixes threads on the IETF |
The issue was discussed in a meeting on 2024-04-10
View the transcript2.1. Revisit Verifiable Credential media types (issue vc-data-model#1462)See github issue vc-data-model#1462. Brent Zundel: next topic to discuss is - 1462, revisit VC media type.
Brent Zundel: here's a link to the discussion that's continuing among the media type mgmt WG at IETF.
Manu Sporny: I won't go into the summary in too much depth, there's a link to it here. Brent Zundel: I'm wondering -- my perspective, chair hat off, it seems like one of the reasons we'd want to move forward with a media type registered now, is because a data format that has a media type registered, there's a perception that it's "a real thing",.
Ivan Herman: I am pretty worried about all of these things; we've been fighting w this for I don't know how many years now. Ted Thibodeau Jr.: my sense of the IETF position at this moment is - there are a couple of very loud voices who have been around for a while, and type a lot, who are very much against what is being called "multiple suffixes", which I think of as sub-subtypes. Manu Sporny: I agree with a lot of what Ted said, I do think there is a minority opinion driving the discussion at IETF. Ivan Herman: i have the impression that we are widely agreeing. the only thing I'd ask for this PR, which I agree with, can you also make a PR which adds something into the charter proposal for the future WG. Manu Sporny: happy to do that. Brent Zundel: sounds like we have a path forward. |
IANA registrations requested, per Wednesday's working group decision: https://mailarchive.ietf.org/arch/msg/media-types/_pmQrj8nkW25FOqIXmPa1wyzizU/ |
Looks like we're building an ontology of media types. That's a fair use case for this description with a long history. I like it! |
After the mediaman meeting we need to revisit our media types and likely change them
The text was updated successfully, but these errors were encountered: