Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

We should find a better term than "DID Registry" and better define what it refers to #162

Closed
selfissued opened this issue Jan 29, 2020 · 18 comments
Assignees
Labels
editorial Editors should update the spec then close pending close Issue will be closed shortly if no objections

Comments

@selfissued
Copy link
Contributor

The Terminology section includes the term "DID Registry", although what it refers to is not actually a registry in the normal standards use of the term. We should find a different term that doesn't cause this semantic confusion.

Furthermore, as described at w3c/did-use-cases#14, there isn't a clear explanation of what it means for the DID to be recorded, or what properties a registry has. For instance, using database terminology, if the registry is a database, what consistency and/or atomicity and durability properties of the database entries are assumed and are necessary? I suspect there's a lot here that bears fleshing out.

@rhiaro
Copy link
Member

rhiaro commented Feb 4, 2020

The DID Registry has at times been known as the "target system" and before that just "the ledger" (I think, before we nailed down that DIDs don't require DLT). See w3c-ccg/did-spec#184 for the history and some links to related issues. It's pretty clear still not everybody is happy with the term, so proposals for something better would be welcome.

@rhiaro rhiaro added discuss Needs further discussion before a pull request can be created editorial Editors should update the spec then close labels Feb 4, 2020
@peacekeeper
Copy link
Contributor

I agree we should try to replace the term, especially considering that at last week's DID WG F2F meeting we agreed that we would introduce registries for interoperability of extensions.

When we introduced the term "DID registry" to the spec, the first goal was to simply have a single term for this across the entire spec, but I think many of us were never completely happy with it.

Here are some ideas:

  • DID network
  • DID (data) source
  • DID origin
  • DID storage/store

Others?

@selfissued
Copy link
Contributor Author

Others:

  • DID Authority
  • DID Repository
  • DID Backing Store
  • DID Storage Agent

@talltree
Copy link
Contributor

talltree commented Feb 6, 2020

I propose we use the same term as the Verifiable Credentials spec:

  • Verifiable data registry

Reasons:

  • It is general enough to cover all the potential back-end systems or networks that could be used for DIDs.
  • It doesn't suggest that the system needs to be a blockchain, DLT, distributed file system, or any other specific type of back-end.
  • It reuses a term already defined in the VC spec and underscores the synergy with VCs.
  • It suggests that DIDs can be used with all kinds of verifiable data, not just VCs, which is true.
  • No one is going to confuse a verifiable data registry with the W3C DID Extension Registry.

@talltree
Copy link
Contributor

talltree commented Mar 9, 2020

A note that I had this terminology discussion at last week's Hyperledger Global Forum in Phoenix and found strong support for the term verifiable data registry because it aligns with the same term used by the Verifiable Credentials spec.

@peacekeeper
Copy link
Contributor

I think verifiable data registry makes sense, +1

@rhiaro
Copy link
Member

rhiaro commented Mar 10, 2020

My understanding was that we picked DID Registry as a more specific type of verifiable data registry (and it's defined as so). I also thought it is primarily the word 'registry' that is contentious.

(Not an objection, just a point of interest.)

@talltree
Copy link
Contributor

@rhiaro It is true that "DID Registry" was defined as being a more specific type of verifiable data registry. But IMHO therein actually lies the problem. The term "DID Registry" makes it sound like: a) the only type of data supported by such an animal is DIDs and DID documents, and b) that a DID Registry operates like a conventional registry for other types of identifiers, e.g., domain names.

In practice, neither of those is true. Almost every system for which a DID method has been written deals with more than just DIDs/DID documents, and none of them operate like conventional centralized identifier registries.

Both of those problems are ameliorated by using the term Verifiable Data Registry. The "Verifiable Data" part generalizes the type of data that might be stored/managed. It also suggests (at least to me) a broader definition of how a system might function as a registry.

Finally, I believe there is significant benefit of having alignment with the same term being used by the Verifiable Credentials Data Model 1.0 specification.

If there are no objections, I propose to submit a PR to add this term to the Terminology section and update the term throughout the spec.

@kdenhartog
Copy link
Member

I'm sure this isn't a novel idea, so I'm curious why we opted away from the term DID Directory or Verifiable Data Directory?

@rhiaro
Copy link
Member

rhiaro commented Mar 31, 2020

I like "repository", "store" and "source". "Directory" is also fine I think. Whether it is prefixed with DID or Verifiable Data is fine. I take Drummond's point that we don't want to imply the system in question is only for DIDs.

The main thing is I think we're asking for trouble if we keep using "registry" here because of the easy conflation with the Property/Parameter/Method Registries.

@peacekeeper
Copy link
Contributor

Another argument against using the term "registry" (besides 1. confusion with the Property/Parameter/Method Registries, and 2. traditional association of the term "registry" with centralized systems) may be that new ideas for DID methods are becoming broader. E.g. the thread in #233 suggests that DIDs could be used to identify hashed software, or atoms in the periodic table. For those types of DIDs, the term "registry" does not seem appropriate.

@panickervinod
Copy link

I do think verifiable data Registry makes sense +1
If you see this Registry as associated with a domain or organisation I suggest Verifiable Organization DID Registry for an organisation or a particular domain.

@kdenhartog
Copy link
Member

I've had moderate degree of success describing ledgers similar to certificate transparency logs. What about something like identifier transparency logs or transparent identifier directory to have the name indicate the similarities?

@selfissued
Copy link
Contributor Author

When creating #277, it was glaringlyobvious, given the proximity of the uses of normal industry term "registry" and the term "DID Registry", which has an unrelated meaning, that we must replace the term "DID Registry" with something more accurate and more descriptive. Otherwise, we're just sowing needless confusion.

@rhiaro
Copy link
Member

rhiaro commented May 12, 2020

@selfissued how do you feel about "Verifiable Data Registry" to align with the VC spec?

@rhiaro rhiaro added pr exists There is an open PR to address this issue and removed discuss Needs further discussion before a pull request can be created labels May 31, 2020
@rhiaro rhiaro added pending close Issue will be closed shortly if no objections and removed pr exists There is an open PR to address this issue labels Jun 15, 2020
@rhiaro
Copy link
Member

rhiaro commented Jun 15, 2020

"DID registry" has been replaced with "verifiable data registry" throughout.

@brentzundel
Copy link
Member

No comments since marked pending close, closing.

@OR13
Copy link
Contributor

OR13 commented Apr 21, 2022

This ship has sailed: https://www.w3.org/TR/did-core/#dfn-verifiable-data-registry

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
editorial Editors should update the spec then close pending close Issue will be closed shortly if no objections
Projects
None yet
Development

No branches or pull requests

8 participants