ENUM for $expand, $select, and $orderby is too restrictive about odata-openapi

[snebjorn]

So that's a yes if I open a PR on swagger-ui and fix the anyOf UI 🎉 - challenge accepted 😄

Update:
Seems something is coming down the pipe: swagger-api/swagger-ui#3803

[ralfhandl]

@snebjorn you are essential correct.

However the purpose of OpenAPI descriptions for OData services is to give a gentle introduction into some of the most prominent features and an easy "Try it out" experience in Swagger UI. They in no way describe the full set of possible requests. For example direct access to properties such as Employees/1234567/lastName is allowed and supported by many OData service frameworks out-of-the-box, and is not mentioned in the OpenAPI descriptions because it would make them unreadably long and cluttered.

For me the benchmark is "does it look nice in Swagger UI", and with the above anyOf construct - while semantically correct - it does no longer look nice in Swagger UI, which then completely ignores the enum values.

So I accept the incompleteness of the current enum construct and prefer the clickable multi-select list demonstrating the most basic features of $select and $expand.