ResourceSwagger should be completely refactored and renamed to ResourceOpenApi
The refactored solution needs to enable an API first methodology, as well as generate documentation on the fly. This means that:
- OpenApi yaml files need to be stored within ApiOpenStudio (apiopenstudio).
- There is a way to generate and edit OpenApi definitions from a resource definition (apiopenstudio and apiopenstudio_admin).
- The user can import an OpenApi definition and automatically generate a resource stub definition (apiopenstudio and apiopenstudio_admin).
- The user can view definitions available to them, using "Swagger UI" (?) (apiopenstudio and apiopenstudio_admin). q-
- Swagger 2 and OpenApi 3 will be supported.
- A script should be created to automatically update to new OpenApi standards.
- A script should be created to automatically update to new domain, this is because the domain is now not just in settings.yaml but also in the OpenApi fragments assigned to applications.