Closed simleo closed 2 years ago
Before I settle on the w3id and versioning, we need to agree on the naming..
I am thinking:
https://www.researchobject.org/workflow-run-crate/profiles/0.1/
https://www.researchobject.org/workflow-run-crate/profiles/0.1/process_run_crate/
https://www.researchobject.org/workflow-run-crate/profiles/0.1/workflow_run_crate/
https://www.researchobject.org/workflow-run-crate/profiles/0.1/provenance_run_crate/
(Not yet registered! I will add to https://github.com/perma-id/w3id.org/tree/master/ro )
And them equivalent symlinks for those for current versions without 0.1-draft/
I am not sure if we need https://w3id.org/ro/wfrun/0.1
as that won't be used in conformsTo
(it is the grouping of the 3 profiles) but we can just include it for completeness/citation.
Now we have:
Workflow Run Crate
- Part of: Workflow Run RO-Crate
Which sounds confusing.. what do we call that grouping in profiles.md
?
It think a lot of the confusion comes from the fact that sometimes we've talked about "profiles" and other times about "profile levels". We can say that there's only one profile with three levels (but I guess that does not work well with conformsTo
) or say that there are three separate profiles, which happen to be collected here because they are related, but their collection is not a profile itself. I went for the latter option in 044a3be. How does it look now? With this new arrangement it makes sense to get rid of https://w3id.org/ro/wfrun/0.1, as you suggested (this also allows to have different versions for the three profiles, though I'm not sure if we should do that).
OK, I agree with going for the "The Workflow Run RO-Crate profile collection" and potentially separate versions if we need so later. Let's merge!
Adds the current profile draft to the repository. Most of these contents have been previously authored by @stain and me in a Google doc, with suggestions and comments from the Workflow Run RO-Crate community. I reviewed the whole text and expanded some sections, mainly the one about the Provenance Run Crate profile.
Main changes:
name
properties from MUST to SHOULD. Names are not required for consumption and forcing their appearance might lead to made up names like "action001" or just more or less verbatim copies of the@id
.mainEntity
MUST be the workflow that's been executed, i.e., the one referenced by theCreateAction
viainstrument
. A crate whose main entity is workflow A, but describes the run of some other application B would be pretty odd and harder to consume.CreateAction
instances. I previously wrote that as a SHOULD, but without step executions it would just be a workflow run crate.A rendering of this is rooted at https://simleo.github.io/workflow-run-crate/. The top-level page for the profile is https://simleo.github.io/workflow-run-crate/profile. Note that I've changed the Jekyll theme because in the current one the rendering of tables is very confusing.