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

Register DID service names #402

Open
mmccool opened this issue Aug 29, 2022 · 6 comments
Open

Register DID service names #402

mmccool opened this issue Aug 29, 2022 · 6 comments
Assignees

Comments

@mmccool
Copy link
Contributor

mmccool commented Aug 29, 2022

  • Actually register (with appropriate DID repo) the WotThing and WotDirectory service names
@mmccool
Copy link
Contributor Author

mmccool commented Dec 15, 2022

Below is the email with instructions that I got from Manu Sporny. There is currently only one other service type registered, for DIDComm, which I plan to use as a template. However, it seems that a JSON-LD context file (and URL) are also needed. I have created this PR: w3c/did-extensions#486

Registration isn't required, but is encouraged. There is a "Service Types" section in the DID Specification Registries:

https://w3c.github.io/did-spec-registries/#service-types

You can name a service type anything you'd like (as long as it doesn't
clash with anything else in the document)... though they typically
take the following form:

WotThing
WotDirectory

Also, ensure that the JSON-LD Context you include in the DID Document
defines both of those class names above.

You can raise a PR to add those service types in this section:

https://github.com/w3c/did-spec-registries/blob/main/index.html#L1527

on this repo:

https://github.com/w3c/did-spec-registries/pulls

@mmccool
Copy link
Contributor Author

mmccool commented Dec 15, 2022

The URL I am proposing for the context file: https://www.w3.org/2021/wot/discovery/did
This is similar to the one we already have in the spec but adds a "did" suffix since I think we want a context file that ONLY defines these two terms. Also, we may need to add an assertion to specify this URL in the WoT Discovery spec which would be a normative change. On the other hand, if it is specified in the DID Registry perhaps that can be considered the normative reference and updating the example in our spec would be sufficient - although we also need to add that reference. To discuss. Obviously making normative changes in our spec during CR will be difficult (I'm hoping however that we can ask for "Director approval" if it is necessary).

@mmccool
Copy link
Contributor Author

mmccool commented Dec 19, 2022

Need to update the WoT Discovery spec to match the DID registry, including the @context. To do (1 at least, 2 and 3 need to be discussed):

  1. Update the examples to include the @context (informative, not a problem)
  2. Add a normative reference to DID registry (normative reference... don't need to add an assertion to WoT Discovery)
  3. Add an assertion defining the @context (new assertion - normative content)

We definitely need special permission for doing 3 during CR period; not sure about 2. Need to talk to @plehegar...

McCool: will create PR (to Editor's version) updating the example to be consistent with what has been submitted to DID registration.

@mmccool
Copy link
Contributor Author

mmccool commented Dec 19, 2022

Could also add an editor's note to this section about this issue. Since it is at risk, we could also convert the whole thing to an informative section and call it "experimental". Also note that if we remove or change 6.5 we have to change the "DID Considerations" (section 12/12.1).

@mmccool
Copy link
Contributor Author

mmccool commented May 22, 2023

Have updated DID PR to be consistent with Discovery spec, but not yet merged into DID repo - needs a dereferencable ontology file. Registrations are technically separate, but we should finalize it before the end of the current charter.

@mmccool
Copy link
Contributor Author

mmccool commented Mar 4, 2024

PR in DID registry is completed and reviews have passed, now just waiting for merge. See w3c/did-extensions#486

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant