Permalinks

Permalink URI scheme

The CWL permalink URI scheme is composed like this:

https://w3id.org/cwl/v/{scheme}/{commit}/{path}#{anchor}

• https://w3id.org/cwl/v/ fixed prefix at permalink service https://w3id.org/ (/cwl is our namespace)
• {scheme} - source code management protocol, currently only git supported:
  • {commit} - full git commit sha1 id (no branches or short commits allowed)
  • {path} - relative path to .cwl file within a checkout of that git commit
  • #{anchor} - an optional anchor, e.g. #main as-is from cwltool --print-rdf ; not passed on to server

Any git permalinks are resolved using https://view.commonwl.org/git which will see if it knows about that particular git commit in any of its indexed public workflows - however anyone can mint these permalinks for .cwl files in any public or private git repository. (If it is later added to the CWL viewer the link would resolve)