fix: remove generated schema.yml file from git

[mentonin]

This file is being removed as it can be generated from the backend code and is an unecessary burden to manually sync in git.

• Closes Enforce OpenAPI schema updates in CI #1910

[felipebergamin]

shouldn't we also add it to .gitignore ?

[mentonin]

gitignored

[tales-aparecida]

Add some lines of docs on how to create it

[mentonin]

Add some lines of docs on how to create it

We have documentation on backend/README.md

[MarceloRobert]

I don't see much reason to remove this from the git but it's fine for me. I think that we can rephrase the readme though, it currently says "Please use it whenever the ins and outs of endpoints change." and I guess that's not going to be needed anymore.

[tales-aparecida]

Actually, I'm not sure I agree with this MR. We should be intentional of changes in the API, and commiting the schema is a good way to do that.

The CI should check whether the author changed the API accidentally, by running generate-schema.sh and blocking in case it gets updated, such that the author must state they intended and expected an update to the schema by commiting an updated version of it.

[mentonin]

I actually agree with you, Tales. I uploaded a new PR (#1992) that adds a check to pre-commit and CI instead