Xibo Swagger json errors

I am trying to use a tool to help integrate that digests the Swagger docs.
My problem is it chokes on the file with many complaints. I am trying to use the same swagger found here: https://xibo.org.uk/manual/api/
Even trying to open it in the Swagger Editor it chokes on may errors.
Is there some other version that fixes the many errors or is this something I can get help in correcting?

The swagger.json file is generated from the docblocs in the source files and the latest version is always generated on release.

You are more than welcome to contribute to that improving those, either by reporting the errors, or by making the changes yourself. (all PRs are greatly received!).