common-workflow-language / user_guide

The CWL v1.0 - v1.2 user guide
http://www.commonwl.org/user_guide/
Other
42 stars 67 forks source link

Operations: Don't imply an operation is straightforwardly useable #404

Closed zoe-translates closed 1 year ago

zoe-translates commented 1 year ago

The doc says "[An operation] can be used like use a command line tool or an expression", which may be read as "you can use an (abstract) operation just like how you use a (concrete) command line tool or expression". This is of course false and directly contradicted by the next example.

To avoid this implication, reword it as "it can appear...".

Also, a minor clarification about "Sphinx Graphviz", which referred to a specific processing directive in the Sphinx doc.