address review comments

Author: mr-c

CommandLineTool.yml

@@ -46,8 +46,11 @@ $graph:
       CWL have been changed to aid the auto-generation of libraries for the reading
       and writing of CWL documents.
 
-      Do not write `cwlVersion: v1.2.1`, that is not a valid version of the CWL
-      syntax.
+      Do not write `cwlVersion: v1.2.1`, nor `cwlVersion: v1.2.0`. The syntax
+      meaning of all terms in CWL `1.2.x is the same. However, when reporting
+      results from running the CWL conformance tests, please do report all
+      three components; for example "99% of CWL v1.2.0 required tests" or
+      "100% of CWL v1.2.1 required tests".
 
       See also the [Schema-Salad v1.2.1 changelog](SchemaSalad.html#Changelog_for_v1.2.1)
 
@@ -151,9 +154,9 @@ $graph:
         unserialized hints to normal objects themselves.
 
       ### Updated Conformance Tests for v1.2.1
-      * Conformance tests are now referred to by their textual identifiers (`id`). Previously
-        this was the `label` field. Tests without a `label`/`id` have been give
-        one.
+      * Conformance tests are now referred to by their textual identifiers (`id`).
+        Previously this was the `label` field. Tests without a `label`/`id`
+        have been given one.
       * `tests/loadContents/cwloutput-nolimit.cwl`: Made explicit that
         `bigstring` is an additional output as generated by the existing
         `mkfilelist.py` script's use of [`cwl.output.json`](#Output_binding).
@@ -245,7 +248,7 @@ $graph:
         scientific notation.
 
       #### `MultipleInputFeatureRequirement`
-      * `multiple-input-feature-requirement`: MultipleInputFeatureRequirement on
+      * `multiple-input-feature-requirement`: `MultipleInputFeatureRequirement` on
         workflow outputs.
 
       #### `InitialWorkDirRequirement`

Workflow.yml

@@ -43,8 +43,11 @@ $graph:
       CWL have been changed to aid the auto-generation of libraries for the reading
       and writing of CWL documents.
 
-      Do not write `cwlVersion: v1.2.1`, that is not a valid version of the CWL
-      syntax.
+      Do not write `cwlVersion: v1.2.1`, nor `cwlVersion: v1.2.0`. The syntax
+      meaning of all terms in CWL `1.2.x is the same. However, when reporting
+      results from running the CWL conformance tests, please do report all
+      three components; for example "99% of CWL v1.2.0 required tests" or
+      "100% of CWL v1.2.1 required tests".
 
       See also the [CommandLineTool v1.2.1 changelog](CommandLineTool.html#Changelog_for_v1.2.1)
       and the [Schema-Salad v1.2.1 changelog](SchemaSalad.html#Changelog_for_v1.2.1).
@@ -87,9 +90,9 @@ $graph:
         implementation. This has been made explicit along with the plan to fix
         this oversight in CWL v1.3.
       * The purpose and valid circumstances for using `Workflow.id`, `ExpressionTool.id`,
-        or `Operation.id` has been made more explicit: It is a unique identifier for that Process;
-        Only useful for when those are in a `$graph`. This `id` value should
-        not be exposed to users in graphical or terminal user interfaces.
+        or `Operation.id` have been made more explicit: It is a unique identifier
+        for that Process; Only useful for when those are in a `$graph`. This `id`
+        value should not be exposed to users in graphical or terminal user interfaces.
 
       ### Clarifications to the schema in CWL v1.2.1 to aid autogenerated libraries
       Many CWL parsing/generating libraries are autogenerated from the official schema