Skip to content
This repository has been archived by the owner on Oct 29, 2019. It is now read-only.

[Overview] Need for clarification in first paragraph #117

Closed
mwherman2000 opened this issue Dec 18, 2018 · 0 comments
Closed

[Overview] Need for clarification in first paragraph #117

mwherman2000 opened this issue Dec 18, 2018 · 0 comments
Labels
editorial Editorial changes to the specification

Comments

@mwherman2000
Copy link

mwherman2000 commented Dec 18, 2018

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 Fix people info. #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 Fix people info. #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.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
editorial Editorial changes to the specification
Projects
None yet
Development

No branches or pull requests

2 participants