explain workaround and enum order

Author: caroott

src/ARCtrl/Conversion/Workflow.fs

@@ -29,10 +29,14 @@ type WorkflowConversion =
         // Check if it's a simple string (shorthand like "File[]", "string?")
         match yamlElement with
         | YAMLicious.YAMLiciousTypes.YAMLElement.Value _ ->
-            // Shorthand format
+            // Shorthand format: parse string directly without YAML context
+            // Note: YAMLicious.Decode.object requires a YAMLElement for its API,
+            // but cwlTypeStringMatcher only uses the 'get' function and ignores the element.
+            // This placeholder satisfies the function without affecting the actual parsing.
+            let placeholderElement = YAMLicious.YAMLiciousTypes.YAMLElement.Comment "unused-shorthand-context"
             YAMLicious.Decode.object (fun get ->
                 CWL.Decode.cwlTypeStringMatcher t get
-            ) (YAMLicious.YAMLiciousTypes.YAMLElement.Comment "placeholder")
+            ) placeholderElement
             |> fst
         | YAMLicious.YAMLiciousTypes.YAMLElement.Object [YAMLicious.YAMLiciousTypes.YAMLElement.Sequence items] ->
             // YAML array wrapped in Object (happens when parsing multi-line YAML arrays)

src/CWL/CWLTypes.fs

@@ -33,6 +33,8 @@ type DirentInstance = {
     Writable: bool option
 }
 
+/// Represents an enumeration type with a defined set of valid symbol values.
+/// Per the CWL specification, symbol order is semantically significant and preserved during serialization.
 [<CustomEquality; NoComparison>]
 type InputEnumSchema = {
     Symbols: ResizeArray<string>
@@ -41,6 +43,9 @@ type InputEnumSchema = {
     Name: string option
 }
     with
+        /// Equality comparison that treats symbol order as significant.
+        /// Two enums are equal only if their symbols appear in the same order.
+        /// This follows the CWL specification where enum symbol order matters.
         override this.Equals(o: obj): bool =
             match o with
             | :? InputEnumSchema as other ->