Finally, the Roar README got completely rewritten - it now covers all the aspects as the underlying representable gem, rendering and parsing REST representations, nesting, coercion, HAL and Collection+JSON, client-side support and a lot more.