Дак тыкается-то именно сгенерированный файл сваггера, а не докблоки ;)
Точнее сгенерированный файл полсовывается визуализатору.
Ну да. И он же и в постман импортируется.
Докблок нужен только что бы все инструкции ты мог помещать в контроллеры, реквесты, т.е. недалеко от кода, а не в отрыве от него