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

Discovery context and namespace under w3.org/ns #148

Closed
farshidtz opened this issue Mar 27, 2021 · 7 comments
Closed

Discovery context and namespace under w3.org/ns #148

farshidtz opened this issue Mar 27, 2021 · 7 comments
Assignees

Comments

@farshidtz
Copy link
Member

farshidtz commented Mar 27, 2021

The discovery spec currently references the context and ontology using the draft URL.

What is the process of hosting these under w3.org/ns/wot-discovery?

I found the following, already defined by the WoT WG:

Once this is done, we can update the referenced context URLs and the namespace for type URIs. Also related to #54.

@farshidtz
Copy link
Member Author

farshidtz commented Apr 16, 2021

@ashimura any idea? There are many "draft" URLs in the spec and ontology and it is getting out of hand.

@mmccool
Copy link
Contributor

mmccool commented May 10, 2021

Options

  1. Use a sub-URL under td, e.g. https://www.w3.org/ns/td/discovery ... however, wot-security is separate for some reason... we should figure out what, maybe it matters here too.
  2. Continue to use github for now (makes testing easier), add an ednote saying it will be changed in the final version. (Late binding and back-patching)
  3. Assume a given URL, use it in all examples, and add an ednote saying it is tentative and may change. Nicer to read, makes testing harder.

I would suggest option 2 (@farshidtz to check there is a note and if not, create it), and then explore option 1 (@ashimura and @mmccool; email to @sebastiankb and @plehegar).

@mmccool
Copy link
Contributor

mmccool commented May 17, 2021

@mmccool to create a PR for option 2.

@mmccool mmccool self-assigned this May 17, 2021
farshidtz added a commit to farshidtz/w3c-wot-discovery that referenced this issue May 26, 2021
mmccool pushed a commit that referenced this issue May 31, 2021
* Update exploration figure

* Rename DirectoryDescription to ThingDirectory

* Switch from aggregation to generic association

* consolidated diagrams

* consolidated section to define discovery models and ontology

* Add notes for tentative context and type URIs, related to #148

* Improvements to diagrams and text

* Minor improvements to the text

Co-authored-by: Ben Francis <ben@tola.me.uk>
@mmccool mmccool added the Resolve by CR Issues that need to be resolved by CR label Aug 22, 2022
@mmccool
Copy link
Contributor

mmccool commented Sep 5, 2022

I seems I was supposed to do a PR to implement option 2. Will at least check it has been done, in time for the CR transition.
But at this point, we can use a combination of 1 and 3:

  • Normatively propose a URL as in 1, that will go into CR transition
  • Add an ed note that says that for the purposes of testing, implementations may use the github URL up until PR.

@mmccool - need a PR, prior to CR transition.

@mmccool
Copy link
Contributor

mmccool commented Sep 26, 2022

Ed note is there, but we still need to resolve by PR. Changing label to "Resolve by PR".

@mmccool mmccool added resolve by PR and removed Resolve by CR Issues that need to be resolved by CR labels Sep 26, 2022
@benfrancis
Copy link
Member

To clarify, what value should implementations currently be using for the @context of Directory TDs and Enriched TDs?

Currently there's an assertion in section 7.1.1.1 which enforces https://www.w3.org/2021/wot/discovery#ThingDirectory, but examples use http://www.w3.org/ns/td for TD and https://w3c.github.io/wot-discovery/context/discovery-context.jsonld for Discovery.

Meanwhile, the TD specification clearly specifies https://www.w3.org/2022/wot/td/v1.1 for the latest version of TDs.

Am I correct in understanding during CR status we should use:

@context: [
  "https://www.w3.org/2022/wot/td/v1.1", 
  "https://w3c.github.io/wot-discovery/context/discovery-context.jsonld"
]

for both Directory TDs and Enriched TDs inside a Directory, until the URL for Discovery is finalised?

@mmccool
Copy link
Contributor

mmccool commented May 22, 2023

Think this is all sorted out now, closing.

@mmccool mmccool closed this as completed May 22, 2023
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

3 participants