From 7e08f75cc8dc85b9fab128d07c90ff5766e802b1 Mon Sep 17 00:00:00 2001 From: Vincent Langlet Date: Tue, 24 Mar 2026 19:46:06 +0100 Subject: [PATCH] fix(openapi): fallback description on summary --- src/OpenApi/Factory/OpenApiFactory.php | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/src/OpenApi/Factory/OpenApiFactory.php b/src/OpenApi/Factory/OpenApiFactory.php index 351b9d68193..745692fdda4 100644 --- a/src/OpenApi/Factory/OpenApiFactory.php +++ b/src/OpenApi/Factory/OpenApiFactory.php @@ -231,13 +231,15 @@ private function collectPaths(ApiResource $resource, ResourceMetadataCollection $openapiOperation = $openapiAttribute; } + $summary = null !== $openapiOperation->getSummary() ? $openapiOperation->getSummary() : $this->getPathDescription($resourceShortName, $method, $operation instanceof CollectionOperationInterface); + // Complete with defaults $openapiOperation = new Operation( operationId: null !== $openapiOperation->getOperationId() ? $openapiOperation->getOperationId() : $this->normalizeOperationName($operationName), tags: null !== $openapiOperation->getTags() ? $openapiOperation->getTags() : [$operation->getShortName() ?: $resourceShortName], responses: null !== $openapiOperation->getResponses() ? $openapiOperation->getResponses() : [], - summary: null !== $openapiOperation->getSummary() ? $openapiOperation->getSummary() : $this->getPathDescription($resourceShortName, $method, $operation instanceof CollectionOperationInterface), - description: null !== $openapiOperation->getDescription() ? $openapiOperation->getDescription() : $this->getPathDescription($resourceShortName, $method, $operation instanceof CollectionOperationInterface), + summary: $summary, + description: null !== $openapiOperation->getDescription() ? $openapiOperation->getDescription() : $summary, externalDocs: $openapiOperation->getExternalDocs(), parameters: null !== $openapiOperation->getParameters() ? $openapiOperation->getParameters() : [], requestBody: $openapiOperation->getRequestBody(),