Skip to content

use tag URI for core vocabulary IDs #890

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

Closed
notEthan opened this issue Apr 8, 2020 · 3 comments
Closed

use tag URI for core vocabulary IDs #890

notEthan opened this issue Apr 8, 2020 · 3 comments

Comments

@notEthan
Copy link
Contributor

notEthan commented Apr 8, 2020

I suggest JSON schema changes the core vocabulary ID URIs from https to tag.

-https://json-schema.org/draft/20XX-XX/vocab/core
+tag:json-schema.org,2019:draft/20XX-XX/vocab/core

along with all the rest of the vocab/* vocabularies

instead of using a transport protocol for vocabularies, which have no document to transport, why not use a uri that is simply an identifier? the tag URI seems like it was built for this. (I think most of the json schema members are familiar, but a tag URI is described at taguri.org, wikipedia, its RFC.)

this would help alleviate confusion on the part of people looking for retrievable resources at vocabulary URIs (#815).

@handrews
Copy link
Contributor

handrews commented Apr 8, 2020

I considered this, but decided against it primarily because the intention is that there will be something there in the future. tag URIs, which I love and use in various other projects, are not incredibly familiar to most people. If we planned to leave the URIs not pointing to anything, it would be worth asking people to understand them.

However, that is not the plan. I do not want to create extra mental load in understanding vocabularies and then just switch back to something more familiar.

Please remember that JSON Schema is a draft. It is supposed to have unfinished pieces here and there. Otherwise, we'd finalize it. This is one of the main unfinished pieces, and it's like this on purpose.

@notEthan
Copy link
Contributor Author

notEthan commented Apr 8, 2020

sounds good. thanks for the consideration @handrews

@notEthan notEthan closed this as completed Apr 8, 2020
@awwright
Copy link
Member

awwright commented Apr 9, 2020

I'll also chime in tag: URIs are great, I use them for resources that I know are not going to be documents... e.g. so I can have a tag: URI describing some thing, and an http: URI for a document about that thing. I use this technique to build tables of things with links to documents about those things, e.g. https://fullstack.wiki/http/headers/index

I agree with @handrews but it's not a bad idea to keep in mind @notEthan, thanks for the suggestion!

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

No branches or pull requests

3 participants