@joeyAghion => Pragmatic RESTful API Design in the Artsy Public HAL+JSON API

I wrote a post introducing the new API and some design decisions behind its public face. I didn't go into details about testing or implementation, those could be probably separate and good topics.

Would appreciate feedback from @joeyAghion and everyone else, especially if you saw something in APIv2 that you think is worth talking about.
Don't need "specific" twice here. The last 2 sentences are confusing... is the default backward compatible or just the current version? (I don't know.)