From 0bd7016e6f06197cacaf8281781f6957a723433a Mon Sep 17 00:00:00 2001
From: Vincent Amstoutz <vincent.amstoutz@outlook.com>
Date: Sun, 8 Jun 2025 12:09:48 +0200
Subject: [PATCH] docs(core/dtos): improve by adding other usages

fix(dto): remove useless doc

fix(operation): remove unused operation

fix(typing): wrong return type

fix(lint/md): bare url
---
 core/dto.md           | 26 ++++++++++++++++++++++++++
 core/upgrade-guide.md |  5 ++---
 2 files changed, 28 insertions(+), 3 deletions(-)

diff --git a/core/dto.md b/core/dto.md
index ca47d83cc14..35f05532603 100644
--- a/core/dto.md
+++ b/core/dto.md
@@ -213,3 +213,29 @@ final class BookRepresentationProcessor implements ProcessorInterface
     }
 }
 ```
+
+## DTO without response
+
+Sometimes we need DTOs to process something, but we don't need to send an object in response.
+Assuming that, we can disable the output for our API Resource using the following code:
+
+```php
+<?php
+// api/src/ApiResource/Book.php with Symfony or app/ApiResource/Book.php with Laravel
+
+declare(strict_types=1);
+
+namespace App\ApiResource;
+
+use ApiPlatform\Metadata\ApiResource;
+use App\Dto\BookInput;
+
+#[ApiResource(
+    input: BookInput::class,
+    output: false, // Disables the response
+)]
+final class Book
+{
+    // ...
+}
+```
diff --git a/core/upgrade-guide.md b/core/upgrade-guide.md
index 00a594301ad..7ba1892d9c5 100644
--- a/core/upgrade-guide.md
+++ b/core/upgrade-guide.md
@@ -141,6 +141,5 @@ As this is an `extraProperties` it's configurable per resource/operation. This i
 
 ### OpenApi context
 
-You may want to convert your openApiContext to openapi, doing so is quite fastidious, @lyrixx created a rector script to help if needed:
-
-https://github.com/lyrixx/rector-apip-openapi
+You may want to convert your openApiContext to openapi, doing so is quite fastidious, @lyrixx created a rector script to
+help if needed: [lyrixx/rector-apip-openapi](https://github.com/lyrixx/rector-apip-openapi).