From 7858afec09ddcdeffe4e48bbd91f87b0caf16376 Mon Sep 17 00:00:00 2001
From: Yoann Laissus <yoann.laissus@jeresiliemoncontrat.com>
Date: Tue, 30 Mar 2021 14:19:33 +0200
Subject: [PATCH] Display form type childs description and title properly

---
 ModelDescriber/FormModelDescriber.php | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/ModelDescriber/FormModelDescriber.php b/ModelDescriber/FormModelDescriber.php
index c4f423f..6bff0e4 100644
--- a/ModelDescriber/FormModelDescriber.php
+++ b/ModelDescriber/FormModelDescriber.php
@@ -124,7 +124,14 @@ final class FormModelDescriber implements ModelDescriberInterface, ModelRegistry
                 null,
                 $config->getOptions()
             );
-            $property->ref = $this->modelRegistry->register($model);
+
+            $ref = $this->modelRegistry->register($model);
+            // We need to use allOf for description and title to be displayed
+            if ($config->hasOption('documentation') && !empty($config->getOption('documentation'))) {
+                $property->allOf = [new OA\Schema(['ref' => $ref])];
+            } else {
+                $property->ref = $ref;
+            }
 
             return;
         }