@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 is impressive and really works! We'll lose most readers here as they browse the API directly (a good thing).

I'd write out the full URL rather than hiding it in the href. I'd also indicate that there are more links excluded from the JSON response (e.g., via `// ...`).