Hacker News new | ask | show | jobs
by jconnolly 4858 days ago
Stop writing self-documenting API specs and settle on a hypermedia spec, like Hal or Siren! reply
1 comments

I actually have no idea why the hal people aren't writing hal specifications for existing services right now--it's not quite as nice as "native" support, but the format supports it, and it would be useful to see what a hal version of the Twitter API looked like, for example.
hal is currently going through the ID -> RFC process, once it's an RFC, I'm sure you'll see stuff like this.