We currently have manual documentation which is incomplete in usage.md.

We would like to use the the Pydantic models and openapi.json to populate the markdown docs automatically.