Improve augment parameters (#1803)

Author: DerManoMann

src/Processors/AugmentParameters.php

@@ -84,19 +84,18 @@ protected function augmentOperationParameters(Analysis $analysis): void
             if (!Generator::isDefault($operation->parameters)) {
                 $tags = [];
                 $this->extractContent($operation->_context->comment, $tags);
-                if (array_key_exists('param', $tags)) {
-                    foreach ($tags['param'] as $name => $details) {
-                        foreach ($operation->parameters as $parameter) {
-                            if ($parameter->name == $name) {
-                                if (Generator::isDefault($parameter->description) && $details['description']) {
-                                    $parameter->description = $details['description'];
-                                }
+                $docblockParams = $tags['param'] ?? [];
+
+                foreach ($operation->parameters as $parameter) {
+                    if (Generator::isDefault($parameter->description)) {
+                        if (array_key_exists($parameter->name, $docblockParams)) {
+                            $details = $docblockParams[$parameter->name];
+                            if ($details['description']) {
+                                $parameter->description = $details['description'];
                             }
                         }
                     }
-                }
 
-                foreach ($operation->parameters as $parameter) {
                     if (!Generator::isDefault($parameter->schema)) {
                         $this->mapNativeType($parameter->schema, $parameter->schema->type);
                     }