[Meta Issue] Expanding JSON Schema/JSON References

[webron]

JSON Schema and JSON References are mostly well defined, but they are not necessarily fully fit for API documentation. We'll collect the requests to break out of some of the restrictions.

Please do not add comments directly to this issue.