w3c-ccg / did-spec

Please see README.md for latest version being developed by W3C DID WG.
https://w3c.github.io/did-core/
Other
124 stars 45 forks source link

[Overview] Need for clarification in first paragraph #117

Closed mwherman2000 closed 5 years ago

mwherman2000 commented 5 years ago

In https://w3c-ccg.github.io/did-spec/#overview, it states...

The entities are identified by decentralized identifiers (DIDs). They may authenticate via proofs (e.g., digital signatures, privacy-preserving biometric protocols, etc.). DIDs point to DID Documents. A DID Document contains a set of service endpoints for interacting with the entity. Following the dictums of Privacy by Design, each entity may have as many DIDs as necessary, to respect the entity’s desired separation of identities, personas, and contexts.

1a. What does "The entities are..." refer to? ...are these DID Documents? ...are these "decentralized resources", are these "credentials", ...? The term entities used here is confuding.

1b. What does "entities" refer to this? This is vague. What are these "entities" in real-life? ...in a DID data model, what/where are these "entities"? For example, do we need to specifically identify/call out the concept of a DID Entity?

  1. "A DID Document contains a set of service endpoints for interacting with the entity". See #1. Also, to the first time reader, this sounds like a DID Document only contains a set of Service Endpoints (which is not true). Please reword/clarify.

  2. "Each entity may have as many DIDs as necessary." This is vague/misleading. What does "entity" refer to in this sentence/context? Is an entity equivalent to a DID Document? See #1. I believe entities (more specifically DID Entities) needs to be called out and defined as a formal term ...with a diagram ...something like...

Hyperledger Indy/Sovrin Comprehensive Architecture Reference Model (INDY ARM) - latest version - bullets (12) thru (16) in both the diagram, Narration, and principles.