Что вы используете для документирования REST API в laravel?

Question

[Дархан]

Доброго времени суток!
Что взять для документирования API?
Swagger L5 удручает написанием огромного количества кода в phpdoc, что он становиться в 3-5 раз больше самого метода контроллера.
Что используете вы в проектах? Что можете посоветовать?

Comments

[Sanes]

У Qiwi и Hetzner посмотрите. Что-то похожее на готовое решение.
Зачастую обычная таблица используется.

Answer 1

[Иван Шумов]

До сих пор кроме swagger (openapi) ничего лучше не придумали. Был ещё raml, но не в курсе жив ли он. Просто как и все - вы делаете ошибку описывая спеку в коде. Эти спеки все для top to bottom проектирования

Comments

[prrrrrrr]

Был ещё raml, но не в курсе жив ли он.

до сих пор юзаю его

[Иван Шумов]

prrrrrrr, он очень редко используется командами, поэтому я его уже забыл