Problem/Motivation
It's unclear whether we want to support operations like PUT using HAL, or whether we should just expect application/json.
Related discussions on the HAL mailing list:
- granularity of link relations and embedding resources
- POST/PATCH/PUT with Hal discusses whether state of embedded resources should be handled on PUT/POST/PATCH
- embedding links in a non-convoluted way discusses a similar approach to one we've been thinking about, having _links for all entity references but then also including the entity reference information in the state of the resource.
- HAL representation for PUT/POST/PATCH, in which Mike Kelly says "But, sure, definitely use HAL if you want to be able to write links, or include nested resources, in write requests."