Allow for entity documentation to support an array of entities

This allows for using the $ref element in the swagger spec to display nested relationships.
This test should be a lot more explicit, doing a `JSON.parse` and looking specifically for the things affected by multiple `response_classes`.