Vocabularies and Contexts
We have, at the moment, a number of vocabulary and context files residing on various GitHub repositories, either explicitly or generated via GitHub actions. When we go to Proposed Recommendations, it is probably cleaner and safer to copy all these as static files to the W3C server, i.e., not making them dependent on GitHub once all our documents are standards.
The public URLs for the context and vocabulary files have been already defined (some were done several years ago) and partially deployed; those should remain as they are. At this moment, these URLs are all redirected, either by an .htaccess file or via w3id.org to github.io. The proposal therefore is to copy all files into the W3C Date Space, and systematically change the redirections. The structure of the target date space structure could be:
https://www.w3.org/2025/credentials/vcdm/examples/undefined-terms
/json-schema//vcdi/multikey/jwk
/sl/cid
(An alternative might be to move /cid to the top, i.e., use https://www.w3.org/2025/cid. However, taking into account that these URLs are never really visible to the outside world, it makes the management of all these marginally easier to keep everything at one place.)
Here is a (hopefully) complete list of what we have now, and where they should be
1 VDCM
- Core context file:
- URL: https://www.w3.org/ns/credentials/v2
- Redirected via
https://www.w3.org/ns/credentials/.htaccessto https://w3c.github.io/vc-data-model/contexts/credentials/v2 - To be redirected to: https://www.w3.org/2025/credentials/vcdm/context.jsonld
- Core vocabulary:
- URL: https://www.w3.org/2018/credentials/
- Redirected via
https://www.w3.org/2018/credentials/.htaccessto https://w3c.github.io/vc-data-model/vocab/credentials/v2/vocabulary.html (and .ttl, .jsonld, .svg via content negotiation). - To be redirected to: https://www.w3.org/2025/credentials/vcdm/vocabulary.{html,jsonld,ttl,svg} (with content negotiation)
- Example context file:
- URL https://www.w3.org/ns/credentials/examples/v2
- Redirected via
https://www.w3.org/ns/credentials/.htaccessto https://w3c.github.io/vc-data-model/contexts/credentials/examples/v2 - To be redirected to: https://www.w3.org/2025/credentials/vcdm/examples/context.jsonld
- Undefined context file:
- URL: https://www.w3.org/ns/credentials/undefined-terms/v2
- Redirected via
https://www.w3.org/ns/credentials/.htaccessto https://w3c.github.io/vc-data-model/contexts/credentials/undefined-terms/v2 - To be redirected to: https://www.w3.org/2025/credentials/vcdm/undefined-terms/context.jsonld
- Undefined vocabulary:
- URL: https://www.w3.org/ns/credentials/undefined-term#
- Redirected via
https://www.w3.org/2018/credentials/.htaccessto https://w3c.github.io/vc-data-model/vocab/credentials/v2/undefined-term.html - To be redirected to: https://www.w3.org/2025/credentials/vcdm/undefined-term/vocabulary.html
2 JSON Schema
- Core schema:
- URL: https://www.w3.org/ns/credentials/json-schema/v2.json (or simply v2)
- Redirected via
https://www.w3.org/2018/credentials/json-schema/.htaccessto https://w3c.github.io/vc-json-schema/schema/json-schema-credential-schema.json - To be redirected to: https://www.w3.org/2025/credentials/json-schema/v2.json
3 Data Integrity
- Context file:
- URL: https://w3id.org/security/data-integrity/v2
- Redirected via w3id.org to: https://w3c.github.io/vc-data-integrity/contexts/data-integrity/v2.jsonld
- To be redirected to: https://www.w3.org/2025/credentials/vcdi/context.jsonld
- Vocabulary files:
- URL: https://w3id.org/security#
- Redirected via w3id.org to: https://w3c.github.io/vc-data-integrity/vocab/security/vocabulary.html (and .ttl and .jsonld via content negotiation)
- To be redirected to: https://www.w3.org/2025/credentials/vcdi/vocabulary.{html,jsonld,ttl,svg} (with content negotiation)
- Multikey context file:
- URL: https://w3id.org/security/multikey/v1
- Redirected via w3id.org to: https://w3c.github.io/vc-data-integrity/contexts/multikey/v1.jsonld
- To be redirected to: https://www.w3.org/2025/credentials/vcdi/multikey/context.jsonld
- JWK context file:
- URL: https://w3id.org/security/jwk/v1
- Redirected via w3id to: https://w3c.github.io/vc-data-integrity/contexts/jwk/v1.jsonld
- To be redirected to: https://www.w3.org/2025/credentials/vcdi/jwk/context.jsonld
4 Status Lists
- Context file:
- URL: https://www.w3.org/ns/credentials/status/v1
- Redirected, via
https://www.w3.org/ns/credentials/status/.htaccessto https://w3c.github.io/vc-bitstring-status-list/contexts/v1.jsonld - To be redirected to: https://www.w3.org/2025/credentials/sl/context.jsonld
- Vocabulary files:
- URL: https://www.w3.org/ns/credentials/status#
- Redirected, via
https://www.w3.org/2018/credentials/status/.htaccessto https://w3c.github.io/vc-bitstring-status-list/vocab/vocabulary.html (and .ttl and .jsonld via content negotiation) - To be redirected to: https://www.w3.org/2025/credentials/sl/vocabulary.{html,jsonld,ttl,svg} (with content negotiation)
5 Controlled Identity
- Context file:
- URL: https://www.w3.org/ns/cid/v1
- Redirected, via
https://www.w3.org/ns/cid/.htaccessto https://w3c.github.io/cid/context/v1.jsonld - To be redirected to: https://www.w3.org/2025/credentials/cid/context.jsonld (There is no separate vocabulary file for CID, the terms are part of the security vocabulary.)