Merge pull request #34 from common-workflow-language/clarify_runtime_dirs

language saying platforms can do what they want except when they can't

Author: mr-c

CommandLineTool.yml

@@ -81,6 +81,8 @@ $graph:
         * Clarify CommandLineTool.arguments documentation
         * Clarify that runtime.outdir and runtime.tmpdir must be distinct
           directories.
+        * Clarify that unspecified details related to execution are left open to
+          the platform.
 
       See also the [CWL Workflow Description, v1.1.0-dev1 changelog](Workflow.html#Changelog).
 
@@ -110,10 +112,12 @@ $graph:
       provide a common standard description of grammar and semantics for
       invoking programs used in data-intensive fields such as Bioinformatics,
       Chemistry, Physics, Astronomy, and Statistics.  This specification
-      defines a precise data and execution model for Command Line Tools that
+      attempts to define a precise data and execution model for Command Line Tools that
       can be implemented on a variety of computing platforms, ranging from a
       single workstation to cluster, grid, cloud, and high performance
-      computing platforms.
+      computing platforms. Details related to execution of these programs not
+      laid out in this specification are open to interpretation by the computing
+      platform implementing this specification.
 
     - {$include: concepts.md}
     - {$include: invocation.md}

Workflow.yml

@@ -74,6 +74,8 @@ $graph:
         * [Addition](#Requirements_and_hints) of `cwl:requirments` field to
           input object documents
         * `secondaryFiles` can now be explicitly marked as `required` or not.
+        * Add note that undefined details related to execution are left open to
+          the platform.
 
       See also the [CWL Command Line Tool Description, v1.1.0-dev1 changelog](CommandLineTool.html#Changelog).
 
@@ -84,7 +86,9 @@ $graph:
       Physics, and Astronomy.  This specification is intended to define a data
       and execution model for Workflows that can be implemented on top of a
       variety of computing platforms, ranging from an individual workstation to
-      cluster, grid, cloud, and high performance computing systems.
+      cluster, grid, cloud, and high performance computing systems. Details related
+      to execution of these workflow not laid out in this specification are open to
+      interpretation by the computing platform implementing this specification.
 
     - {$include: concepts.md}