Skip to content
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

Terminology needs to be revised #983

Closed
RieksJ opened this issue Nov 28, 2022 · 4 comments
Closed

Terminology needs to be revised #983

RieksJ opened this issue Nov 28, 2022 · 4 comments
Labels
editorial Purely editorial changes to the specification. terminology

Comments

@RieksJ
Copy link

RieksJ commented Nov 28, 2022

In a message to the W3C Credentials CG list, @msporny made a couple of statements, e.g.:

The three VC ecosystem roles have always been an imprecise simplification to get the most important concepts across.

The bulk of his message is part of an argument that finds it roots in this 'imprecise simplification' of (in this case) the issuer. He concludes by saying:

I just wanted to correct this critical misperception, specifically, because it led to a variety of misunderstandings in your previous post. I'll get around to responding to the rest of your email as I have time... there's a lot to unpack there. :)

I would not be surprised if Manu (and with him: many others) would have to spend increasingly more time addressing critical (or noncritical) misperceptions unless we mature (and professionalize) the terminology/definitions that are the source of these misperceptions.

In fact, I think that the time and effort that is needed (once) to do this is much less than the time and effort that will be needed (many more times) to address misperceptions. Also, I think any text (standard, white paper, ...) that commits to using well-defined terms will be of a higher quality (i.e.: are easier to read, more difficult to misinterpret) than texts that use immature terms.

@mwherman2000
Copy link

mwherman2000 commented Nov 28, 2022

Update: moved to #984

I hope it is OK to ask a clarifying question about the VC 3-role model? ...a perhaps naïve question about the Verifier role...

Is the Verifier role
(a) a "service" that can be asked to verify the authenticity of a VC for someone? ...or...
(b) is the Verifier the someone who is seeking to have the authenticity of a VC verified?
...they're quite different.

...do you have link that explains your choice (e.g. into the VC spec)?

A Bank is used in many Verifier examples (not sure if its used in the VC spec itself) ...this choice doesn't provide any clarity because a Bank can be both an (a) and a (b).

This definition from the VC spec isn't adequate...

A role an entity performs by receiving one or more verifiable credentials, optionally inside a verifiable presentation for processing.

@RieksJ
Copy link
Author

RieksJ commented Nov 28, 2022

The fact that this question arises is yet another proof that revision of the terminology is needed, as a properly defined set of terms would definitely answer that question. Addressing the question itself is outside the scope of this issue (but could be raised as a separate one).

@brentzundel brentzundel added the editorial Purely editorial changes to the specification. label Dec 7, 2022
@RieksJ
Copy link
Author

RieksJ commented Dec 12, 2022

@brentzundel, @msporny, @dlongley, @kdenhartog: can any of you create a label terminology and add that to (a) this issue, (b) other terminology-related issues, e.g., #989, #984, w3c/vc-imp-guide#70, #915, #912, #902, and (c) all issues that I will be creating for proposing improved definitions for terms, the title of which I intend to start with the text [Terminology]?.

What I will be trying to do is to make the definitions such that every first sentence is a criterion that we can use to determine whether or not something qualifies as an instance/example of the term.

@Sakurann
Copy link
Contributor

There is an agreement in the WG that terminology needs to be revised - and now we have a termonology tag and number of issues focusing on specific terms. Please keep opening concrete issues with the terms that should be redefined, ideally with a proposal how to redefine. Closing this general issue as there is no action pending.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
editorial Purely editorial changes to the specification. terminology
Projects
None yet
Development

No branches or pull requests

4 participants