контроллеров для размещения только в них документации, чтобы не засорять рабочие файлы. На сколько распространен такой подход ?
Норм
но в таком случае ты не держишь доку рядом с кодом. И зачем тогда darkaonline/l5-swagger? имхо в этом случае проше сразу писать свагер доку в yaml или json (есть редакторы для этого).
Находил ваш ответ о написании документации сразу в json. Тоже думал об таком пути .. В phpstorm можно создать OpenAPI файлы - https://www.jetbrains.com/help/phpstorm/openapi.html
их много разных. Мне проще мышкой наклацать, чем запоминать синтаккс тегов
Обсуждают сегодня