web-api-style
web-api-style copied to clipboard
Detail the Custom Interface constraint
Suggested by Robert Brewer.
Under "Custom Interface", it would be very informative to lay out in detail which of the properties are being traded off when selecting explicit versioning. Not to evangelize them over REST or vice-versa, but to understand in which situations each is appropriate.
versioning is a technique, not a feature. elevating vesioning to a property/requirement is, IMO, a very bad idea.
I agree that versionning is not a feature, it just comes in the blog post to illustrate the Custom Interface constraint and the properties it results in.
This should likely go into an Evaluation section (see related issue #17).