Support for top-level `included` object

[maurei]

The top-level included object needs to be included in the OpenApi schemas for response documents.

Things to consider:

• If the resource graph should be recursively parsed to identify which types are allowed in the included section in the response document associated with a particular resource, and if allowed schema for included should be limited to these types
• Whether to support resource inheritance