Idea for xRegistry spec:
- One resource can not only have multiple versions, but also multiple documents representations of it
- Ideally, there is just one document that is the source of truth, but other documents can be automatically derived from it
- E.g. an API could be described with EDMX, and the OpenAPI 2, OpenAPI3 and 3.1 definitions of it are derived
- Consumers may only support certain document description formats and would like to see which ones are available and pick the best choice to them
- A consumer may not care which document formats are derived or original.
- Like versions, the document formats should have a "default" fallback.
- For server and consumer it would be easier if API operations are not polymorphic and return different responses based on a query parameter