formatting and stuff

[ci skip]
introduce error indication

[ci skip]
add guarantees about embedded properties

This allows clients to safely skip loading linked resources in case they
are already embedded.
Otherwise they could not safely assume which properties are embedded and
for which they'd need to resolve the link.

It should also simplify the API implementation as there is only
a single representation neccessary.

[ci skip]