Hacker News new | ask | show | jobs
by Pooge 464 days ago
> automatically generated OpenAPI specifications + API documentation

I'd much rather have engineers write OpenAPI specification files by hand and then generate their server code from that file. Way easier to maintain and actually forces devs to have good documentation for their APIs.

1 comments

Is there an actual example of this in the wild?

I have seen things that generate server stubs but have not encountered something that enforces things like error code/response types etc.

Indeed it doesn't enforce the response code and type. However, it's still a big step in the right direction to enforce request and response schema.