[JSON API](http://jsonapi.org/) - [ ] convert resources to output json-api compliant responses - [ ] update api documentation to refer to json-api spec and have new examples - [ ] automate checking for compliance with json-api schema
