3 ms·
Stop writing self-documenting API specs and settle on a hypermedia spec, like Hal or Siren! reply
by jconnolly 14y ago
Stop writing self-documenting API specs and settle on a hypermedia spec, like Hal or Siren!
reply
- mjs 14y agoI 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.
- steveklabnik 14y agohal is currently going through the ID -> RFC process, once it's an RFC, I'm sure you'll see stuff like this.