Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

> 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.



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.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: