Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

This looks great!

I don't know how to properly version documentation, and how to prevent accidentally documenting responses for the wrong version number. Any recommendations?

Maybe including API version in the response so errors of that kind become very obvious ?



Good question. In my case, I use the Org file instead of Postman (or some other API client) and I keep it in the same repo with the code.

When I generate the `index.html` from Org, I point it at my local API, so there is never any doubt they are on the same version.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: