Generating an OpenAPI Schema automatically

[Lugrim]

We may still want to tweak it a bit

• Check if it is possible to sort in categories
• Add the generation of the schema to the manual CI
• Tweak all the auto-generated documentation to ensure it really represents the reality

Will close #89 when merged

[Lymkwi]

So how does this work? Is there a command to run? Is it supposed to expose a specific API endpoint?

[Lugrim]

So how does this work? Is there a command to run? Is it supposed to expose a specific API endpoint?

For now there's a command, I use docker exec -it infra-insalanfr-beta-backend-1 python manage.py generateschema --file openapi-schema.yml when pyyaml and uritemplate are installed in the docker, but I'm thinking about addind a CI to directly generate a schema then a swagger that would be deployed as every other documentation statics

[Lugrim]

Ok so exploring this a bit, it will require a lot of work to ensure everything in the existing code base is right and correctly documented since we do some serialization by hand. We can put this on hold for later.

[Lugrim]

Done better in #145