Documentation-Driven Development: практическое руководство по генерации Go-кода из OpenAPI спецификаций с помощью oapi-codegen
Программный комитет ещё не принял решения по этому докладу
Целевая аудитория
Тезисы
Устали поддерживать актуальность Swagger-документации вручную после каждого изменения API? Вам знакомо чувство, когда разработчики работают по устаревшей спецификации?
Я расскажу, как мы внедрили Documentation-Driven подход в продакшене: теперь OpenAPI-спецификация — это единственный источник истины. Из неё мы автоматически генерируем Go-код сервера на любом фреймворке (echo/chi/…), клиентские SDK и даже валидацию для 15+ микросервисов. Мы сократили время на согласование API на 70% и полностью исключили рассогласование кода и документации.
Вы получите готовое пошаговое руководство: от написания первой спецификации в openapi.yaml до интеграции генерации в CI/CD при помощи Docker. Покажу, как за два часа настроить процесс, который сэкономит вашей команде сотни человеко-часов в год.
Прошёл путь от стажёра до сеньора, успел потимлидить. В настоящее время развивает инфраструктуру MWS. Любит музыку и увлекается информационной безопасностью в разработке.