@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.
"This actually had the exact opposite effect on overall performance and user experience than we have ever anticipated." - is phrased oddly, and we never actually know what we anticipated. Maybe clearer as 'This actually had a profoundly negative effect on...' or another variation?