search

w3c / did-core

W3C Decentralized Identifier Specification v1.0
https://www.w3.org/TR/did-core/
Other
404 stars 94 forks source link

Re-writing the intro paragraph of §5.1 #683

Closed iherman closed 3 years ago

iherman commented 3 years ago

The introductory paragraph in §5.1 says:

It is necessary to learn the identifiers used within a DID document to refer to the DID subject and the DID controller, as well as any alternate identifiers that might also be used to reference the DID subject. The following section elaborates on the mechanisms the DID document data model provides for so doing.

I was not fully sure what this paragraph really tries to say and, in any case, "necessary to learn" is not an acceptable style for a specification. Also, the generic statement on identifiers is not accurate: identifiers in a DID document are also used to identify verification methods or services.

The PR proposes an alternate formulation based on my understanding (which may be entirely wrong!).

Preview | Diff

msporny commented 3 years ago

Editorial, multiple reviews, changes requested and made, no objections, merging.