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

[use-cases] We need to consistently use our terms #58

Open
halindrome opened this issue Feb 14, 2016 · 3 comments
Open

[use-cases] We need to consistently use our terms #58

halindrome opened this issue Feb 14, 2016 · 3 comments

Comments

@halindrome
Copy link
Contributor

There are a lot of terms. For the sake of our readers, we need to use them consistently. And we should use as few unique ones as possible! I propose that we use these:

issuer - the entity that issues the credential.
holder - the entity that the credential is about, and who "holds" onto it.
consumer - the entity that needs to receive and analyze a credential.

Let's avoid terms like "recipient" - that has a flow feel to it and will change depending on how the data is flowing.

Thoughts @gkellogg, @burnburn, @bsletten ?

@burnburn
Copy link
Contributor

Yes, I didn't like recipient myself, but it was the term used most consistently in the use cases I saw, so I continued using it. Your new suggestions are fine. Once you say go I'm happy to convert all the terms in my section to match what you list above.

@halindrome
Copy link
Contributor Author

Fair enough. While you are waiting, if you look in ../common/terms.html there are a bunch of terms defined. I imagine we could define more, but maybe it would be worth a review for everyone.

@bsletten
Copy link
Contributor

Thanks for all the consolidation work, Shane. I am speaking all day today but will do a pull tonight and hopefully a bit of work tomorrow morning.

On Feb 14, 2016, at 7:30 AM, Shane McCarron notifications@github.com wrote:

Fair enough. While you are waiting, if you look in ../common/terms.html there are a bunch of terms defined. I imagine we could define more, but maybe it would be worth a review for everyone.


Reply to this email directly or view it on GitHub #58 (comment).

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

No branches or pull requests

3 participants