Skip to content
Documentation & entrest itself are a work in progress (expect breaking changes). Check out the GitHub Project to contribute.

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