Что лучше apiDoc или swagger?
у swagger пользователей больше апидока в 20+ раз, смотрите на апидок как на ваше кастомное решение, а на сваггер - как на пром стандарт
Кстати swagger уже устарел. Смотри лучше open api 3. И ещё, есть куча утилит, с помощью которых можно относительно легко самому генерить доки. Я пошел этим путём по swagger, так как стандартные генераторы не понравились