Они пишутся в формате phpdoc’a. Наличие их именно в контроллере, ресурсе, реквесте - более чем удобное. Нет необходимости поддерживать отдельным файл или группу файлов - есть цепочка и связи с которыми работаешь, а сама документация относится к тому методу у которого описана.
Другой вопрос, что все это не очень удобно смотрится с аннотациями php8 :(