http://zalando.github.io/restful-api-guidelines/hyper-media/Hypermedia.html and yes, I agree. I've yet to build a fully HYDRA/JSONLD compatible API myself. https://twitter.com/sbley/status/837241692352806912