Всем привет, пытаюсь разобраться с https://github.com/nelmio/NelmioApiDocBundle используя при этом стандарт

ответа Google JSON (https://google.github.io/styleguide/jsoncstyleguide.xml?showone=data#data)

Описываю ответ следующим образом:
```
* @OA\Response(
* response=200,
* description="Ок",
* @OA\Schema(ref=@Model(type=BaseModelResponse::class)),
* @OA\Schema(
* @OA\Property(
* property="data",
* ref=@Model(type=StatusModelResponse::class),
* )
* )
* )
```

Ожидаю в доке описание модели в следующем виде:
{"data": {"status": "string"}}
Но в результате в дока вообще не подхватывает модель ответа

У кого есть опыт с описанием и может подсказать как правильно описывать модели? Нашел похожую проблему - https://github.com/nelmio/NelmioApiDocBundle/issues/1327, но так и не понял предложений с @Schema::$allOf

Меня закидают говном. Но лично я ушел от аннотаций. Описание все в yaml. Почему? Потому что иногда они начали зашкаливать по своему размеру. Зачем тогда вообще нелмио? Удобный сборщик + секьюрити вход можно в доку организовать.

Аналогично ушел, когда аннотаций в контроллере стало больше кода

сейчас уже переходят активно на атрибуты, они более лаконичны и IDE их понимает

contract first и генерить код по контракту а не контракт их кода 🙂

Ничоу не понял.

Ты видел приличные генераторы пхп-кода по OA3?

их обычно под себя пишут