From a860b904fa1d87aa081cc9d2c0f3cf773f830ac7 Mon Sep 17 00:00:00 2001 From: Manu Sporny Date: Fri, 5 May 2023 21:45:27 -0400 Subject: [PATCH 1/3] Add usage guidance related to the `id` property. --- index.html | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/index.html b/index.html index 1758a6f78..35cb32b78 100644 --- a/index.html +++ b/index.html @@ -1166,14 +1166,17 @@

Contexts

Identifiers

-When expressing statements about a specific thing, such as a person, product, -or organization, it is often useful to use some kind of identifier so that -others can express statements about the same thing. This specification defines -the optional id property for such identifiers. The -id property is intended to unambiguously refer to an object, -such as a person, product, or organization. Using the id -property allows for the expression of statements about specific things in -the verifiable credential. +When expressing statements about a specific thing, such as a person, product, or +organization, it is often useful to use a globally unique identifier for it. +Globally unique identifiers are useful so that others can express statements +about the same thing. This specification defines the optional id +property for such identifiers. Using the id property +allows for the expression of statements about specific things in the +verifiable credential and is set by an issuer when creating +objects in a verifiable credential or a holder when creating +objects in a verifiable presentation. Examples of ids +include UUIDs (`urn:uuid:0c07c1ce-57cb-41af-bef2-1b932b986873`), HTTP URLs +(`https://id.example/123`), and DIDs (`did:example:1234abcd`).

@@ -1202,7 +1205,8 @@

Identifiers

scenarios. There are also other types of correlation mechanisms documented in Section that create privacy concerns. Where privacy is a strong consideration, the id property -MAY be omitted. +MAY be omitted. Not all use cases require the usage of the id +property.

From 7be16eeac22c846caa9c1879e62d8e468ca82a32 Mon Sep 17 00:00:00 2001 From: Manu Sporny Date: Sat, 13 May 2023 14:38:31 -0400 Subject: [PATCH 2/3] Fine tune language in `id` property section. Co-authored-by: Ted Thibodeau Jr Co-authored-by: Dave Longley --- index.html | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/index.html b/index.html index 35cb32b78..939445f45 100644 --- a/index.html +++ b/index.html @@ -1167,14 +1167,14 @@

Identifiers

When expressing statements about a specific thing, such as a person, product, or -organization, it is often useful to use a globally unique identifier for it. -Globally unique identifiers are useful so that others can express statements +organization, it can be useful to use a globally unique identifier for that thing. +Globally unique identifiers enable others to express statements about the same thing. This specification defines the optional id -property for such identifiers. Using the id property +property for such identifiers. The id property allows for the expression of statements about specific things in the -verifiable credential and is set by an issuer when creating -objects in a verifiable credential or a holder when creating -objects in a verifiable presentation. Examples of ids +verifiable credential and is set by an issuer when expressing +objects in a verifiable credential or a holder when expressing +objects in a verifiable presentation. Example id values include UUIDs (`urn:uuid:0c07c1ce-57cb-41af-bef2-1b932b986873`), HTTP URLs (`https://id.example/123`), and DIDs (`did:example:1234abcd`).

@@ -1205,7 +1205,7 @@

Identifiers

scenarios. There are also other types of correlation mechanisms documented in Section that create privacy concerns. Where privacy is a strong consideration, the id property -MAY be omitted. Not all use cases require the usage of the id +MAY be omitted. Some use cases do not require, or explicitly require omitting, the id property.

From 4af336e81ec21330489f1d4fd9b6d988101f0288 Mon Sep 17 00:00:00 2001 From: Manu Sporny Date: Sat, 13 May 2023 14:49:38 -0400 Subject: [PATCH 3/3] Use fragment identifier `id`s in HTTP URL example. --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 939445f45..6774fd385 100644 --- a/index.html +++ b/index.html @@ -1176,7 +1176,7 @@

Identifiers

objects in a verifiable credential or a holder when expressing objects in a verifiable presentation. Example id values include UUIDs (`urn:uuid:0c07c1ce-57cb-41af-bef2-1b932b986873`), HTTP URLs -(`https://id.example/123`), and DIDs (`did:example:1234abcd`). +(`https://id.example/things#123`), and DIDs (`did:example:1234abcd`).