MCLOUD-14020: Normalized function doc block content updation

prateek-karanpuria-adobe · prateek-karanpuria-adobe · commit 464f541c0234 · 2025-10-13T19:44:11.000+05:30
diff --git a/src/Environment/ConfigReader.php b/src/Environment/ConfigReader.php
@@ -81,12 +81,15 @@ public function read(): array
     }
 
     /**
-     * Recursively unwrap Symfony YAML TaggedValue objects and handle common tags
+     * Recursively unwrap Symfony YAML TaggedValue objects and handle common tags.
+     *
+     * This method handles !env, !include, !php/const, and unknown tags,
+     * ensuring all YAML values are normalized to arrays or scalars for safe merging.
      *
      * @param mixed $data
      * @return mixed
      *
-     * @SuppressWarnings(PHPMD.CyclomaticComplexity)
+     * @SuppressWarnings("PHPMD.CyclomaticComplexity") Method is intentionally complex due to tag handling.
      */
     private function normalizeYamlData(mixed $data): mixed
     {

Original file line number	Diff line number	Diff line change
`@@ -81,12 +81,15 @@ public function read(): array`
`81`	`81`	`}`
`82`	`82`
`83`	`83`	`/**`
`84`		`- * Recursively unwrap Symfony YAML TaggedValue objects and handle common tags`
	`84`	`+ * Recursively unwrap Symfony YAML TaggedValue objects and handle common tags.`
	`85`	`+ *`
	`86`	`+ * This method handles !env, !include, !php/const, and unknown tags,`
	`87`	`+ * ensuring all YAML values are normalized to arrays or scalars for safe merging.`
`85`	`88`	`*`
`86`	`89`	`* @param mixed $data`
`87`	`90`	`* @return mixed`
`88`	`91`	`*`
`89`		`- * @SuppressWarnings(PHPMD.CyclomaticComplexity)`
	`92`	`+ * @SuppressWarnings("PHPMD.CyclomaticComplexity") Method is intentionally complex due to tag handling.`
`90`	`93`	`*/`
`91`	`94`	`private function normalizeYamlData(mixed $data): mixed`
`92`	`95`	`{`