Check out Stoplight.io for a good tool for managing swagger documentation. It's a lot easier than managing the YAML itself.