Improvide rendering of API specification
Todays presentation of an API is limited to the operations, sample request/response and schema. It be very useful if (for OpenAPI specifications) the Developer Portal could render the API with the Model datatypes, restrictions etc similar to what swagger-ui/ReDoc does.
The new developer portal already has support for rendering objects. Improved support is tracked with this Issue: https://github.com/Azure/api-management-developer-portal/issues/186
I have found it's difficult to understand complex schemas, ours has lots of AnyOf and OneOf operators, which use different shared components with the spec. In swagger.io the schema view clearly renders these named schema components but because this doesn't it makes it very hard to read large models.