README
This directory contains static files and dependencies for the Swagger UI library to ensure compatibility with Swagger 1.2 (deprecated). Files are managed for manual updates and customization.
Configuration
- Swagger UI Version: 2.2.10
- Source: Swagger UI Repository
- Included Files:
swagger-ui.min.js- Relevant dependencies from the dist/lib directory
Rationale
Files are included directly to avoid adding npm as a build dependency. Deprecated libraries are not loaded from a CDN to maintain control over versions and be able to submit fixes if necessary.
Moving to OpenAPI 3
When transitioning to OpenAPI 3, the current setup should be reevaluated.
- Swagger 1.2 is deprecated, and using an outdated version may introduce maintenance overhead and compatibility issues.
- OpenAPI 3 provides improved functionality, broader tool support, and up-to-date best practices.