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 ?