As discussed in Proposing an alternative to application/vnd.drupal.ld+json, the new plan is to use HAL as the primary format for REST.
Step 1: Support GET with hal+json
To start with, we need to be able to respond to requests for application/hal+json and provide a JSON object back which contains all of the properties.
#1924220: Support serialization in hal+json
Step 2: Support POST/PUT/PATCH/DELETE in the HAL workflow
It's unclear whether we want to support operations like PUT using HAL, or whether we should just expect application/json. There is a related discussion on hal-discuss.
Step 3: Help consumers use the API
- Provide documentation at each /relation/{rel} page (like HAL Talk does)