When it comes to usability one of the main key points that should be taken into consideration is knowing the different personas of your product.
I can identify at least 5 different groups that will use swagger-ui within a products lifecycle:
- API developer
- Client developer
- Consultant introducing the API to client developer
- Tester