Чем документировать API проекта с возможностью поддерживать версии API?

Question

[3ton]

Возникла необходимость описать для сторонних разрабов функциональность API.
Взяли в гуглодоке описали и всем было хорошо, пока API не стал эволюционировать.

Хотелось бы узнать в чем можно вести документирование API с возможностью указывать изменения на каждой ветке

Answer 1

[Эдуард Тибет]

Если речь о REST, то можете попробовать связку swagger editor + git + swagger ui ( www.swagger.io ). Если понравится, то:
- там есть codegen
- вся ручная работа перейдет в src
- будет прямо генерить из кода, подобно doxygen.