Roy Fielding wrote this post recently on the proliferation of APIs that claim to be REST but are breaking some of the fundamental constraints of a REST style architecture.
I was most struck by what Roy seems to be saying is required to document a REST Api.
A description of the media types that are used throughout [...]
Posts