Best Practices
TODO
- best practices
- deduplication
- ensuring min, max, default, examples, descriptions, etc where possible
- optimizing for libraries which generate clients based on the spec
- common error patterns
- 404 for list endpoints (and why)
- tips to make openapi spec smaller