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

Add "author" and "party" to terminology, rewrite "claim" terminology #1172

Closed
wants to merge 35 commits into from
Closed
Changes from all commits
Commits
Show all changes
35 commits
Select commit Hold shift + click to select a range
a215692
update definition of 'claim'
RieksJ Jun 27, 2023
6008f7f
typo fixed
RieksJ Jun 27, 2023
96c7d2d
Added 'party' and updated texts with that term
RieksJ Jun 27, 2023
40129a3
added 'author' and modified some descriptions with it
RieksJ Jun 27, 2023
dbab47d
Addressed all (current) comments.
RieksJ Jun 28, 2023
08a4972
fixed comments by TallTed
RieksJ Jun 29, 2023
ea91405
accommodated Orie's suggestion
RieksJ Jun 29, 2023
da030bb
Addressed TallTed's comments
RieksJ Jun 30, 2023
4221fe4
clarification of issuance
RieksJ Jun 30, 2023
bb780b8
Addressed comment of OR13
RieksJ Jun 30, 2023
17c4421
thanks @davidlehn for spotting typo
RieksJ Jul 3, 2023
06ce351
Update terms.html
RieksJ Jul 4, 2023
a9d8bb9
Addressed Manu's comments
RieksJ Jul 4, 2023
5b9597c
addressed wip-abramson's comments
RieksJ Jul 6, 2023
1b213b1
addressed Ted's comment
RieksJ Jul 7, 2023
8b61aa4
Fix mismatched <UL> in terminology.
msporny Jul 8, 2023
31077c6
addressed TallTeds comment
RieksJ Jul 11, 2023
a09a793
addressed @dlongley's comment
RieksJ Jul 14, 2023
f1ec45c
addressed @brentzundel's suggested change
RieksJ Jul 17, 2023
f900903
Addressed comment by @decentralgabe
RieksJ Jul 18, 2023
abf21e3
Addressed @brentzundel's comment
RieksJ Jul 24, 2023
ec89f9e
removed 'author' as term
RieksJ Jul 24, 2023
e287f14
removed 'party' - should accommodate @brentzundel's and @OR13s comments
RieksJ Jul 25, 2023
d22da0a
comments by @brentzundel and @TallTed
RieksJ Jul 27, 2023
571ae86
comment by @TallTed
RieksJ Jul 31, 2023
a4fb1a4
comments by OR13 and TallTed resolved
RieksJ Aug 1, 2023
3f4448c
addressed comments by @jandrieu and @OR13
RieksJ Aug 2, 2023
788fb36
suggestion by @TallTed
RieksJ Aug 3, 2023
af626d8
attempt to resolve some discussions by various people
RieksJ Aug 5, 2023
16572a9
minor update @TallTed
RieksJ Aug 10, 2023
9172267
Re-used the RDF 'resource' concept to resolve discussions
RieksJ Aug 10, 2023
653c80d
@OR13 comments
RieksJ Aug 11, 2023
246efc4
IRI --> URL
RieksJ Aug 11, 2023
fdecac0
Addressed various comments
RieksJ Aug 14, 2023
c78aeb4
Removed `resource`
RieksJ Aug 14, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 37 additions & 21 deletions terms.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,20 @@
<dl class="termlist">
<dt><dfn data-lt="claims">claim</dfn></dt>
<dd>
An assertion made about a <a>subject</a>.
A digital representation of an assertion made, by a specific <a>entity</a>,
about anything that information can be expressed about, including
not only documents, people, organizations, physical objects, or abstract concepts,
but also <a>issuers</a>, <a>holders</a>, and <a>verifiers</a>.
Comment on lines +8 to +11
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
A digital representation of an assertion made, by a specific <a>entity</a>,
about anything that information can be expressed about, including
not only documents, people, organizations, physical objects, or abstract concepts,
but also <a>issuers</a>, <a>holders</a>, and <a>verifiers</a>.
A digital representation of an assertion made by a specific <a>entity</a>,
about anything that information can be expressed about, including
documents, people, organizations, physical objects, and abstract concepts,
as well as <a>issuers</a>, <a>holders</a>, and <a>verifiers</a>.

The meaning of a claim (its semantics) is determined by its author.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The meaning of a claim (its semantics) is determined by its author.
The meaning of a claim (its semantics) is determined by the entity that
made that particular claim.

Claims can be expressed by <a>issuers</a>, with which to construct a <a>verifiable credential</a>,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Claims can be expressed by <a>issuers</a>, with which to construct a <a>verifiable credential</a>,
Claims can be expressed by <a>issuers</a>, to include in a <a>verifiable credential</a>,

or by <a>holders</a>, to include in a <a>verifiable presentation</a>.
Different <a>issuers</a> and <a>verifiers</a> can reuse the same semantics for claims through the use of shared vocabularies and/or ontologies.
</dd>
<dt><dfn data-lt="credential|credentials">credential</dfn></dt>
<dd>
A set of one or more <a>claims</a> made by an <a>issuer</a>.
The <a>claims</a> in a credential can be about different <a>subjects</a>.
A set of one or more <a>claims</a> created by a single <a>issuer</a>,
RieksJ marked this conversation as resolved.
Show resolved Hide resolved
that is constructed for the purpose of transferring it to some other <a>entity</a>.
The <a>claims</a> in a <a>verifiable credential</a> can have different <a>subjects</a>.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The <a>claims</a> in a <a>verifiable credential</a> can have different <a>subjects</a>.
Each <a>claim</a> in a <a>verifiable credential</a> can have the same or a different
<a>subject</a> than any other <a>claim</a> in the same <a>verifiable credential</a>.

</dd>
<dt><dfn>data minimization</dfn></dt>
<dd>
Expand Down Expand Up @@ -62,17 +70,17 @@
<dt><dfn data-lt="holders|holder's|holders'">holder</dfn></dt>
<dd>
A role an <a>entity</a> might perform by possessing one or more
<a>verifiable credentials</a> and generating <a>presentations</a> from them.
A holder is usually, but not always, a <a>subject</a> of the <a>verifiable
credentials</a> they are holding. Holders store their <a>credentials</a> in
<a>credential repositories</a>.
<a>verifiable credentials</a> and creating <a>verifiable presentations</a> from them.
A holder can be the <a>subject</a> of zero or more <a>claims</a> within
the <a>verifiable credentials</a> they are holding.
Holders store their <a>credentials</a> in <a>credential repositories</a>.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Holders store their <a>credentials</a> in <a>credential repositories</a>.
Holders store <a>credentials</a> in <a>credential repositories</a>.

</dd>
<dt><dfn class="lint-ignore"
data-lt="identities|identity's">identity</dfn></dt>
<dd>
Comment on lines 78 to 80
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This description of identity seems more appropriate to identifier. My identity is not a means of keeping track of me; my identifier is. I am not making a suggestion of how to change the description yet, but changes will be appropriate if line 79 is changed as noted.

We might — or might not — need to define both identifier and identity.....

Suggested change
<dt><dfn class="lint-ignore"
data-lt="identities|identity's">identity</dfn></dt>
<dd>
<dt><dfn class="lint-ignore"
data-lt="identifiers|identifier's">identifier</dfn></dt>
<dd>

The means for keeping track of <a>entities</a> across contexts. Digital
identities enable tracking and customization of <a>entity</a> interactions
across digital contexts, typically using identifiers and attributes. Unintended
The means for keeping track of <a>entities</a> and other people or things that information can be expressed about.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The means for keeping track of <a>entities</a> and other people or things that information can be expressed about.
The means of keeping track of <a>entities</a> about which information can be expressed.

Digital identifiers enable tracking and customization of <a>entity</a> interactions
across digital contexts, typically in conjunction with attributes. Unintended
distribution or use of identity information can compromise privacy. Collection
and use of such information should follow the principle of
<a>data minimization</a>.
Expand All @@ -91,12 +99,12 @@
specifications. This specification decouples the <a>identity provider</a>
concept into two distinct concepts: the <a>issuer</a> and the <a>holder</a>.
</dd>
<dt><dfn data-lt="issuers|issuer's">issuer</dfn></dt>
<dt><dfn data-lt="issuers|issuer's|issuer(s)|issuing|issued">issuer</dfn></dt>
<dd>
A role an <a>entity</a> can perform by asserting <a>claims</a> about one or
more <a>subjects</a>, creating a <a>verifiable credential</a> from these
<a>claims</a>, and transmitting the <a>verifiable credential</a> to a
<a>holder</a>.
A role an <a>entity</a> can perform as it constructs a <a>verifiable credential</a>
from a set of <a>claims</a> it asserts as true, including metadata and proofs,
typically for the purpose of transferring the <a>verifiable credential</a> to
a <a>holder</a>.
</dd>
<dt><dfn data-lt="presentation|presentations">presentation</dfn></dt>
<dd>
Expand All @@ -114,9 +122,14 @@
The ability of a <a>holder</a> to make fine-grained decisions about what
information to share.
</dd>
<dt><dfn data-lt="subjects|subject's">subject</dfn></dt>
<dd>
A thing about which <a>claims</a> are made.
<dt><dfn data-lt="subjects|subject's|subject(s)">subject</dfn></dt>
The person or thing about which a <a>claim</a> is made.
This can not only be documents, people, organizations, physical objects, abstract concepts, etc.,
but also <a>issuers</a>, <a>holders</a>, and <a>verifiers</a>.
Comment on lines +127 to +128
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This can not only be documents, people, organizations, physical objects, abstract concepts, etc.,
but also <a>issuers</a>, <a>holders</a>, and <a>verifiers</a>.
This can be documents, people, organizations, physical objects, abstract concepts, etc.,
as well as <a>issuers</a>, <a>holders</a>, and <a>verifiers</a>.

Note that the common practice of speaking about "*the* <a>subject</a> of a <a>verifiable credential</a>"
may be incorrect, as <a>verifiable credentials</a> can contain multiple <a>claims</a> that have different subjects,
in which case *the* <a>subject</a> of that <a>verifiable credential</a>
is not determinable.
RieksJ marked this conversation as resolved.
Show resolved Hide resolved
</dd>
<dt><dfn class="lint-ignore">user agent</dfn></dt>
<dd>
Expand Down Expand Up @@ -168,9 +181,12 @@
</dd>
<dt><dfn data-lt="verifier|verifiers|verifier's|credential verifiers|credential verifier's">verifier</dfn></dt>
<dd>
A role an <a>entity</a> performs by receiving one or more
<a>verifiable credentials</a>, optionally inside a
<a>verifiable presentation</a> for processing. Other specifications might refer
A role an <a>entity</a> performs by requesting for, and receiving one or more
<a>verifiable presentations</a> (from a <a>holder</a>), that contain
<a>verifiable credentials</a> (or content derived from them) that are authored by <a>entities</a> that it trusts,
Comment on lines +185 to +186
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<a>verifiable presentations</a> (from a <a>holder</a>), that contain
<a>verifiable credentials</a> (or content derived from them) that are authored by <a>entities</a> that it trusts,
<a>verifiable credentials</a> (from a <a>holder</a>), that are issued by <a>entities</a> that it trusts,

IMO, the request is NOT primarily for VPs. The request is for VCs, delivered via VP.

Perhaps more importantly, VCs are issued, not authored.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also, "trust" is irrelevant here.

so that they can reliably be processed for the purpose(s) they have been requested.
The <a>verifiable credentials</a> may be received within a
<a>verifiable presentation</a>. Other specifications might refer
to this concept as a <dfn data-lt="relying parties">relying party</dfn>.
RieksJ marked this conversation as resolved.
Show resolved Hide resolved
</dd>
<dt><dfn data-lt="URL|URLs">URL</dfn></dt>
Expand Down