More/Better Swagger Examples

[Hypfer]

The swagger docs could use some more examples for common things to do such as ordered Segment Cleaning as well as additional proof-reading.

The actual spec is built from many small json files spread all around the project in doc folders via the build_openapi_schema npm script to keep them readable. e.g. https://github.com/Hypfer/Valetudo/blob/master/backend/lib/webserver/capabilityRouters/doc/MapSegmentationCapabilityRouter.openapi.json

[kcindric]

Could you write a list of endpoints which could use additional examples?

[Hypfer]

Actually basically all of them. Only the TimerRouter has some examples

The rest is just infered from the schema by the swagger ui

[kcindric]

Ok, I'll try to commit to this. What a better way to learn a project than go through each and every endpoint :)