On Versioning (RESTish) Web Service APIs
One perennial thing that crops up like crocuses around March, is the
question of the Right Ways To Version RESTish Web Services.
There are
multiple good, unbounded number of bad, and plenty of ugly ways too. But
the Good ones are mostly just pragmatic guidelines; there is no science
behind most of it. Some bad ones are polished, but the real snake oil
comes with the ugly ones. But I digress. Since good ones tend to be
somewhat boring, there's bit less discussion on those.
So it is great to find that there are others whose those align nicely with yours, especially ones that document their thinking. It not only lends credence to your ideas, but makes it easier to express them in form of "have a look at here", sort of as baseline for discussion. In this case there's this in-process document called "Versioning HTTP APIs" that quite nicely serves this purpose.
Anyway: I thought the article is worth reading; and I agree with at least 90+% rate. Which is pretty good, about the rate of agreement with my own writings after a year or so. :-)