link to WDL spec v 1 rather than development version?
Opened this issue · 2 comments
in this section you provide a link to the spec page for the development version of WDL:
"Also, there is some useful, though very detailed, information in the openWDL GitHub repo for the specification itself where you can learn more."
but perhaps for this purpose it's better to link to the version 1 spec, not the development version (here - https://github.com/openwdl/wdl/blob/main/versions/1.0/SPEC.md)
actually, it's kind of weird that these two sentences:
There is emerging documentation about the WDL specification itself being generated by the openWDL community here. Also, there is some useful, though very detailed, information in the openWDL GitHub repo for the specification itself where you can learn more.
are even in the 'Get Test Workflows' section at all. They belong more in the Summary and Next Steps section. If you were to say anything at all here about syntax perhaps it's simply 'don't worry about it right now, it's explained later' or the readthedocs only - the spec is definitely beyond what's needed here
same link comment does apply to section "6.2.1 openWDL specification" - it currently links to the devel spec, and version 1 seems more appropriate