-
Notifications
You must be signed in to change notification settings - Fork 6
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
Make Terminology section normative #91
Conversation
Co-authored-by: Manu Sporny <msporny@digitalbazaar.com>
Co-authored-by: Dave Longley <dlongley@digitalbazaar.com>
Co-authored-by: Dave Longley <dlongley@digitalbazaar.com>
Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com>
We have a family of recommendations, and consistency among those matters. If the terminology section is normative in this specification, it should be in all others and, conversely, if they are not normative in others, then I am opposed to make an exception in this specification. I note that we do have a discrepancy already, which we should address. Indeed, the terminology section in VCDM is normative, whereas the same section in DI is non-normative. (I did not check all the specs in the family.) Personally, I'd probably prefer to have normative terminology sections everywhere, but that should be a WG decision. |
Terminology is normative in VCDM and VC-JOSE-COSE. VC-DATA-INTEGRITY is the odd man out in this regard. |
Note that VC 1.1 terminology used to be non-normative: https://www.w3.org/TR/vc-data-model/#terminology I'm not sure when / where that got changed in 2.0, it might be a mistake. EDIT: This PR made the VCDM change: w3c/vc-data-model#1357 |
The issue was discussed in a meeting on 2024-09-04
View the transcript2.1. Make Terminology section normative (pr controller-document#91)See github pull request controller-document#91. Brent Zundel: most things should be on the PR. Manu Sporny: this is a regular request from Jeffrey Yasskin. Brent Zundel: one, manu's right, we've never marked out terminology section as normative. Ivan Herman: consistency is important as manu has said. Michael Jones: as I said in the issue, there are two different things.
Michael Jones: there's a normative statement..."the entity identified by the id property in the controller document"--that's normative. Manu Sporny: I'll repeat again, this will have zero effect. Brent Zundel: I'm not interested in a philosophical debate.
Brent Zundel: those who don't care can continue not caring.
Brent Zundel: I think we can merge this since it will be harmless. Ivan Herman: just emphasizing that we need to be consistent. Brent Zundel: selfissued, can you make the necessary PRs. Michael Jones: yes. Brent Zundel: any formal objections? |
That the Terminology is normative is a matter of fact. It would be strange and confusing for us to say otherwise in the specification.
Per my comment at , the fact that the Terminology is normative is independent of whether we choose to test statements in the specification that don't contain "MUST".
Fixes #46
Cc: @jyasskin
Preview | Diff