As I truck around the internet in search of documentation for Representational State Transfer (REST), I don’t regularly find guides as complete and specific as this one.  Most are very specification-like and talk about the theory of how REST should work. Vinay gives very pointed advice about how to implement REST in a practical manner.

I particularly like how he points out that HATEOAS is pretty much a pipe dream because of the lack of intelligence in software.

Best Practices for a Pragmatic RESTful API