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

[Overview] DID method used before it is defined #118

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

[Overview] DID method used before it is defined #118

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

To use a DID with a particular distributed ledger or network requires defining a DID method in a separate DID method specification. A DID method specifies the set of rules for how a DID is registered, resolved, updated, and revoked on that specific ledger or network.

  1. DID method and DID method specification are used before they are defined. I believe these are important terms and by not defining them before first use, it creates an unacceptable cognitive load on the first time reader. #confuding

  2. RE: "how a DID is registered, resolved, ..." I believe this statement is neither accurate or precise. After all, a DID is just a character string whose role is to act as an identifier. Isn't more correct to say the DID Document (or DID Entity) "is registered, resolved, updated, and revoked on that specific ledger or network? ...I think so.

Needs to be reworded/clarified. Need to formalize the concept of DID Entity I believe. For example,

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

@mwherman2000 mwherman2000 changed the title [Overview] DID method used before it is define [Overview] DID method used before it is defined Dec 18, 2018
@rhiaro rhiaro added the editorial Editorial changes to the specification label Jan 25, 2019
@rhiaro rhiaro closed this as completed in c0573d8 Mar 3, 2019
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