Если хотите использовать аннотации, для описания документации API прямо в контроллерах, можно попробовать этот пакет:
https://github.com/DarkaOnLine/L5-Swagger. На мой взгляд это слегка многословно и сильно увеличивает количество комментариев/аннотаций в коде, так что рекомендовал бы способы из документации Swagger/OpenAPI.
