Improve embedding of resources guideline.

[tkrop]

Our HAL-based rule Should: Allow Optional Embedding of Sub-Resources predates our new Must: Use Common Hypertext Controls guideline and may not fit perfectly in this new world.

I'm wondering whether the we could find a better guidance here.

[ePaul]

@tkrop will talk to @meshcalero about this.

[ePaul]

@meshcalero will try to do a minimally-invasive PR for this.

[tfrauenstein]

@meshcalero Hi Andreas, you recently said that you 'try to do a minimally-invasive PR for this' which would be great. Do you still have it on your to-do list? Thx.

[ePaul]

Idea: remove the _embedded field, instead use the embed parameter to expand a "common hypertext control" to a full object.

I'll try to figure out how to write this in a rule.

[whiskeysierra]

Isn't _embedded part of the response while the embed parameter is part of the request? How should one substitute one with the other?

[ePaul]

example API using this (internal link).

[ePaul]

Reminder to me: Please finally do it!