add description for newely created methods, fix issues catched by codesniffer

Author: Sergey Nezbritskiy

src/Magento/FunctionalTestingFramework/DataGenerator/Handlers/OperationDefinitionObjectHandler.php

@@ -222,6 +222,8 @@ private function initialize()
     }
 
     /**
+     * Convert headers metadata into an array of objects for further use in.
+     *
      * @param array $opDefArray
      * @return array
      */
@@ -242,6 +244,8 @@ private function initializeHeaders(array $opDefArray): array
     }
 
     /**
+     * Convert params metadata into an array of objects.
+     *
      * @param array $opDefArray
      * @return array
      */

src/Magento/FunctionalTestingFramework/DataGenerator/Persist/OperationDataArrayResolver.php

@@ -103,9 +103,21 @@ public function resolveOperationDataArray($entityObject, $operationMetadata, $op
             $operationElementType = $operationElement->getValue();
 
             if (in_array($operationElementType, self::PRIMITIVE_TYPES)) {
-                $this->resolvePrimitiveReferenceElement($entityObject, $operationElement, $operationElementType, $operationDataArray);
+                $this->resolvePrimitiveReferenceElement(
+                    $entityObject,
+                    $operationElement,
+                    $operationElementType,
+                    $operationDataArray
+                );
             } else {
-                $this->resolveNonPrimitiveReferenceElement($entityObject, $operation, $fromArray, $operationElementType, $operationElement, $operationDataArray);
+                $this->resolveNonPrimitiveReferenceElement(
+                    $entityObject,
+                    $operation,
+                    $fromArray,
+                    $operationElementType,
+                    $operationElement,
+                    $operationDataArray
+                );
             }
         }
 
@@ -323,6 +335,8 @@ private function castValue($type, $value)
     }
 
     /**
+     * Resolve a reference for a primitive piece of data
+     *
      * @param EntityDataObject $entityObject
      * @param $operationElement
      * @param $operationElementType
@@ -364,6 +378,8 @@ private function resolvePrimitiveReferenceElement($entityObject, $operationEleme
     }
 
     /**
+     * Resolves DataObjects referenced by the operation
+     *
      * @param $entityObject
      * @param $operation
      * @param $fromArray