[This page](https://swagger.io/blog/api-design/validate-openapi-definitions-swagger-editor/) gives instructions for how to use a GitHub action that will check the `swagger.yaml` file for syntactic correctness. This might be worth doing for maintenance purposes.
