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
/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 complete list of what we have now, and where they should be. (I hope it is complete, please check!)
1 VDCM
- Core context file:
- Core vocabulary:
- Example context file:
- Undefined context file:
- Undefined vocabulary:
2 JSON Schema
3 Data Integrity
- Context file:
- Vocabulary files:
- Multikey context file:
- JWK context file:
4 Status Lists
- Context file:
- Vocabulary files:
5 Controlled Identity
@brentzundel @msporny @w3c/vc-contributors
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
.htaccessfile or viaw3id.orgtogithub.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
/cidto the top, i.e., usehttps://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 complete list of what we have now, and where they should be. (I hope it is complete, please check!)
1 VDCM
https://www.w3.org/ns/credentials/.htaccessto https://w3c.github.io/vc-data-model/contexts/credentials/v2https://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).https://www.w3.org/ns/credentials/.htaccessto https://w3c.github.io/vc-data-model/contexts/credentials/examples/v2https://www.w3.org/ns/credentials/.htaccessto https://w3c.github.io/vc-data-model/contexts/credentials/undefined-terms/v2https://www.w3.org/ns/credentials/.htaccessto https://w3c.github.io/vc-data-model/vocab/credentials/v2/undefined-term.html2 JSON Schema
https://www.w3.org/2018/credentials/json-schema/.htaccessto https://w3c.github.io/vc-json-schema/schema/json-schema-credential-schema.json3 Data Integrity
4 Status Lists
https://www.w3.org/ns/credentials/status/.htaccessto https://w3c.github.io/vc-bitstring-status-list/contexts/v1.jsonldhttps://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)5 Controlled Identity
https://www.w3.org/ns/cid/.htaccessto https://w3c.github.io/cid/context/v1.jsonld(There is no separate vocabulary file for CID, the terms are part of the security vocabulary.)
@brentzundel @msporny @w3c/vc-contributors