w3c
Added the necessary files for vocabulary deployment
This is the PR on issue #884. It includes the vocabulary description file in YAML, the HTML template file, and also includes a GitHub action to generate the HTML, Turtle, and JSON-LD files, as well as the @context file.
The generated files can be preview-d at https://w3c.github.io/yml2vocab/previews/did/.
More information on the underlying tool can be found at https://github.com/w3c/yml2vocab, with the corresponding package being available on npm and on jsr.
This was discussed during the #did meeting on 29 May 2025.
View the transcript
w3c/did#892
Wip: I want to give Ivan some time to discuss this.
Ivan: There's not too much to discuss. There are actually two things only I added to the PR: GitHub action, but because GitHub actions are always a bit touchy I want Manu to review before merge, and it also required some change on the GitHub setup.
… I think Manu can review. What has to be done is that the visible pages of GitHub have to be generated dynamically rather than as a static thing.
… The other thing is I generated also the context file from the same vocabulary that could be moved somewhere as a result.
… I don't know if we want to do that. Manu, do you want to put it in the same location as the context file for DID?
manu: I'm looking through the PR now, I have minor changes, but it looks good by and large. I think you're doing all the right things here.
We should merge this and see what happens.
… We should merge this and see what happens.
Ivan: I got an error reply from GitHub on the PR, so it must be reviewed.
manu: I agree to auto-generate the context file and the vocabulary. We should get to automatic generation of everything if possible to reduce errors.
… Let's get it merged and fix any issues that arise.
Ivan: What should we do with the context file?
manu: It's just a redirect for now, isn't it? We can keep it as is for now.
Ivan: I'm asking that the tool now also produces context file. We keep it and change the redirect.
