fix(jsonschema): allow embed resources

[soyuka]

#5793 related ping @paullallier @vincentchalamon

[paullallier]

That looks a lots better! A couple things I still see:

There's something odd about the reference back from TestEntity --> BagOfTests in my example. I don't ever use this in my API, so it might be normal - not sure.

Also, I haven't defined the return structure on errors. In alpha2, it didn't try to display them but in this branch it is displaying as something undefined. This might be a feature of the updated SwaggerUI, and it might not be a bad things, since I probably should defined the error return... Though perhaps I shouldn't need to do this explicitly?

In my dev environment, I have the API configured to display on https://main-api (it also displays on https://main-api/docs). In alpha2, it works. In this branch, I get raw json (LD, I think) on https://main-api (the /docs version gives the expect html).

[paullallier]

Oh, and I think that was with e03bb31 No, it was cbecbc9