No reference documentation for `cwltool:CUDARequirement`

[fmigneault]

There is no current definition in https://www.commonwl.org/v1.2/CommandLineTool.html for cwltool:CUDARequirement.
Considering it is the "core" CWL specification, this is understandable.

However, it is mentioned in http://www.commonwl.org/user_guide/introduction/basic-concepts.html#processes-and-requirements
and other tools have also added support for it:

• https://doc.arvados.org/v2.4/user/cwl/cwl-extensions.html#CUDARequirement
• GPU Scheduling Prototype DataBiosphere/toil#4223
• Include additional cwl requirements crim-ca/weaver#494

It would be very helpful to have an official location where this is documented.
It could be placed in an "extensions" section to highlight that it is not core CWL.

[mr-c]

Hello @fmigneault

I agree that proper documentation for extensions like this one are missing. common-workflow-language/common-workflow-language#323 also talks about this

In addition to a rendered schema for the extensions, it would be good to have a list of which CWL implementstions support the extension and the standards track status (not-planned, planned-but-unscheduled, pending-cwl-v1.3, etc..)

[fmigneault]

Thanks to the discussion crim-ca/weaver#506 (comment) and the pointer to https://github.com/common-workflow-language/cwltool/blob/main/cwltool/extensions-v1.2.yml, I found quite a lot of other useful requirements like Secrets that I was not even aware of their existence.

To help in new user adoption of available utilities, I think this documentation should be prioritized.