Why the need for so much formalism with REST?
You GET or POST data, parse a response. Details are somewhat immaterial since they're mostly just values for variables. I'd definitely love to see some standard format for documentation but a world where REST nazis tell me my API lacks lazyass engineer feature X (edit: within the context of a private API) would suck.