search

w3c-ccg / did-method-web

DRAFT: did:web Decentralized Identifier Method Specification
https://w3c-ccg.github.io/did-method-web/
Other
32 stars 17 forks source link

clean up several issues and clarify a few sections #60

Closed mprorock closed 2 years ago

mprorock commented 2 years ago

Added another example, along side cleaning up a few issues noted in the spec.

Additionally reorganized a few text locations for clarity and to avoid repetition

mprorock commented 2 years ago

The additional example appears to be did:key:

  "id": "did:key:z6MktiSzqF9kqwdU8VkdBKx56EYzXfpgnNPUAGznpicNiWfn",

yep - this is pretty common in practice, especially in dev environments - we could change to did:example @OR13 thoughts?

OR13 commented 2 years ago

for did web, I would use did:web examples ONLY... no other DID Methods should be referenced imo... unless there is a really good reason.

gribneau commented 2 years ago

If we're using this additional example to provide clarity to the reader, perhaps explaining that id indicates the subject of this document, and that the subject could use a different DID method would have value.

The term id is not immediately intuitive as an external reference, but an explanation could highlight interoperability between methods.

OR13 commented 2 years ago

id is the only normative requirement for a did document... and its defined by did core:

https://www.w3.org/TR/did-core/#did-subject

id for a did web, should be a DID, that is of the did:web: format.

gribneau commented 2 years ago

id is the only normative requirement for a did document... and its defined by did core:

https://www.w3.org/TR/did-core/#did-subject

id for a did web, should be a DID, that is of the did:web: format.

Yes, I realize that the DID subject (id) is typically the same as the DID example documents, but is that a requirement?

https://www.w3.org/TR/did-core/#also-known-as

In the event that a single subject uses more than one DID, the subject (id) in at least one of the associated documents will match the subject, rather than the DID being resolved to that document.

In this scenario, is there any reason that the DID methods used by the subject and multiple identifiers it uses must match?

mprorock commented 2 years ago

remove references to did:key

@OR13 please take a look at the suggestions i just dropped in to see if those make sense to you as an adjustment

mprorock commented 2 years ago

Make

didDocument.id a DID (did:web:example.com) didDocument.verificationMethod[0].controller a DID (did:web:example.com)

believe this is resolved now @OR13