How to document the project's API with the ability to support API versions?

Question

API

There was a need to describe the functionality of the API for third-party developers.
They took it in Google and described it and everyone was fine until the API began to evolve.
I would like to know how to document the API with the ability to indicate changes on each branch

Answer 1

If we are talking about REST, then you can try the swagger editor + git + swagger ui bundle ( www.swagger.io ). If you like it, then:
- there is codegen
- all manual work will go to src
- it will directly generate from the code, like doxygen.