managed.json contains JSON Schema used to generate the API Description. However, it is currently lacking many "description" fields, which would enhance what is displayed in Swagger UI.
- "title" needed for types
- "description" needed for fields ("title" will be ignored by Swagger UI)
Here is a good example already in managed.json, with "title" and "description" where needed,