Как сгенерировать OpenAPI из Go кода?

Два подхода. Swaggo: пишешь комментарии // @Summary, // @Param, // @Success над хэндлерами, запускаешь swag init — генерируется docs/swagger.json. Плюс — код и дока рядом. Минус — комментарии засоряют код. Второй — ogen: пишешь OpenAPI spec, генерируешь Go-код (server + client). Spec-first даёт лучший контракт. Третий — oapi-codegen: тоже из spec в Go. Выбор зависит от предпочтений: code-first (swaggo) vs spec-first (ogen/oapi-codegen).