Use Open API and then something like https://stoplight.io/ and you will get first class API docs that automatically update with your spec changes.