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
Labels
editorial
Editorial changes to the specification
In https://w3c-ccg.github.io/did-spec/#overview, it states...
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?
"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.
"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.
The text was updated successfully, but these errors were encountered: