Что лучше apiDoc или swagger?

Есть проект на php, и апи этого проекта недокументированно никак.
Поискал и сходу нашёл два решения:
- Swagger
- apiDoc

Как понимаю суть у них одинаковая, на основе аннотаций строится документация.
Попытался определить плюсы и минусы.
- Swagger мне показался более гибким, можно прямо на лету сгенерировать доку, но аннотации слишком объемные и захламляют код.
- apiDoc менее гибкая, но более человеко-понятные аннотации.

Кто пользовался распишите плюсы и минусы, или может еще какое решение есть?