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

Jargon from VCDM and crypto #62

Closed
TzviyaSiegman opened this issue Dec 27, 2019 · 5 comments
Closed

Jargon from VCDM and crypto #62

TzviyaSiegman opened this issue Dec 27, 2019 · 5 comments

Comments

@TzviyaSiegman
Copy link

There is A LOT of jargon in this document that comes from the Verifiable Claims Data Model and will be incomprehensible to a layperson. (verifiable credential, issuer, etc). Likewise, there is the assumption that the reader knows enough about cryptography to make sense of terms like "pairwise-pseudonymous". There is a delicate balance between writing use cases that define the spec and writing use cases that convince people who are not yet adopters that they should be. I find the focal use cases especially difficult to parse.

@CarlosMassiah
Copy link

Could you point out the other terms that are confusing / jargony?

@philarcher
Copy link
Collaborator

You're right Tzviya - I'll take an action to go through and challenge these. I admit I have no idea what pairwise-pseudonymous means.

@philarcher philarcher self-assigned this Apr 1, 2020
@philarcher philarcher added the documentation Improvements or additions to documentation label Apr 1, 2020
@jandrieu
Copy link
Collaborator

@philarcher and I both need to do a full review, keeping this in mind, among other considerations. Some of @TzviyaSiegman's concerns may already have been addressed, but we will look at how to do more.

@philarcher
Copy link
Collaborator

@TzviyaSiegman We believe that as this doc has evolved, your initial comment has been addressed. A lot of those jargon words that you rightly pointed out, have been removed or explained. We'll be seeking full review of the doc by the WG imminently so there's ample opportunity for comment and improvement, should you wish to do so. Otherwise, we'll close this issue next week.

@philarcher philarcher added Close if no further discussion and removed documentation Improvements or additions to documentation labels Feb 12, 2021
@philarcher
Copy link
Collaborator

There having been no further comment and, as flagged, the document is now ready for final review by the WG, I'm closing this issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants