-
Type: Improvement
-
Status: Closed
-
Priority: Major
-
Resolution: Fixed
-
Affects Version/s: V4.01_CS01
-
Fix Version/s: V4.01_CS02
-
Labels:None
-
Environment:
Proposed
-
Proposal:
-
Resolution:
Media entities are a somewhat obscure heirloom from AtomPub, and the "atomic pair" nature of a media resource and its media entity is not clearly explained and not very intuitive.
For example implementations differ in how they treat the content-type:application/json in POST requests to a media entity set:
- some implementations create a media entity using the POST body and do not create a media resource
- some implementations create a JSON media resource using the POST body, plus a media entity pointing to that JSON media resource
We should give guidance on when to use media entities and when to use "normal" entities with stream properties.