Ask HN: How do you write OpenAPI docs?

The way I see it, there are at least two ways of doing this: via codegen/programmatically or writing it manually. Which side are you on?

If you use codegen or similar, what tool do you use? For example there is `swaggo` in Go language, utoipa in Rust, Fastify (JavaScript) can has built-in way to write schema IIRC.

If you write the JSON/YAML manually, how do you write it? Honestly, I want to write it manually but the lack of IDE autocomplete makes it very hard.

Or is there any other way to write it, lemme know.