Что лучше использовать для документирования rest api?

Question

[Turtle_Onni]

Всем привет!

Стоит задача задокументировать имеющиеся API проекта. Back на nodejs. Сборщиком служит gulp. Чем можно описать существующие API и вести документацию с минимальным участием разработчика?

Большое спасибо заранее!

Answer 1

[abbaboka]

Например Swagger/OpenAPI
https://habr.com/company/yamoney/blog/347390/

Answer 2

[alexkdev]

Рекомендую как инструмент Confluence
Неплохой пример как документировать API тут