true story. we could do worse than moving toward something like: http://stateless.co/hal_specification.html.