Documentation-Driven Development: как мы генерируем Go-код из OpenAPI-спецификаций

26.02.2026 14:00:17 | Хабр

Хабы: Блог компании МТС, Go, Подготовка технической документации, Программирование

Привет, Хабр. Я Матвей Лихота, старший Go-разработчик из МТС Web Services. По моему опыту, документация, которую пишут руками отдельно от кода, устаревает уже в момент следующего коммита. Из-за этого мы в команде тратили до 20% времени на поддержание актуальности swagger-документации в десятке микросервисов. И когда ошибки интеграции уже стали привычным фоном, мы все-таки решились и перевернули всё с ног на голову: внедрили Documentation-Driven Development (DDD) — подход в разработке, когда процесс начинается с документации.

Что за подход и что он дал в итоге, зачем понадобилась утилита oapi-codegen и как мы генерируем Go-код из OpenAPI-спецификаций — подробно рассказал и показал под капотом.

Подробнее

Читайте также

Современный подход к управлению киберугрозами: результаты первых внедрений MaxPatrol Carbon
26.02.2026 13:58:44 | Хабр

Суверенный интернет стучится в наши двери
26.02.2026 13:54:42 | Хабр

Коннектор «ПростоКоннектор»: простая интеграция 1С-систем через «1С: Шину»
26.02.2026 13:52:52 | Хабр

Сборка Docker для микросервисов: 7 шагов к идеальному образу
26.02.2026 13:47:09 | Хабр

Как реализована поддержка DDBoost в «Бересте» при работе с Data Domain
26.02.2026 13:41:13 | Хабр

О том, как я попала в мир 1С
26.02.2026 13:35:38 | Хабр

OpenClaw на Raspberry Pi: от установки до мультиагентной системы
26.02.2026 13:35:15 | Хабр

В App Store появилось приложение Active Lab с функциями «Т-Инвестиций»
26.02.2026 13:34:01 | vc.ru

Делаем динамический кол-трекинг: Flask + SQLite + офлайн-конверсии Яндекс.Метрики
26.02.2026 13:28:17 | Хабр

Интуитивная модель индуцированной гравитации: попытка визуализации
26.02.2026 13:24:37 | Хабр

Как HAProxy принимает решения: ACL, mode и маршрутизация трафика
26.02.2026 13:00:13 | Хабр

Налог на криптовалюту в России: что нужно знать в 2026 году
26.02.2026 13:00:04 | Хабр

Как подружить RFID и MAX7219 в проектах Arduino (и не сойти с ума)
26.02.2026 12:57:26 | Хабр

Только эта система управления проектами спасает бизнес во время кризиса
26.02.2026 12:49:53 | Хабр

Эволюция инструментария: как плагины Figma меняют профессию дизайнера интерфейсов
26.02.2026 12:46:39 | Хабр

Юридический техдолг: как он появляется и почему его не видят
26.02.2026 12:45:26 | Хабр

Почему AI не спасёт ваш backlog
26.02.2026 12:41:57 | Хабр

400 000 вникуда: почему новички бросают профессию после дорогих курсов
26.02.2026 12:34:32 | Хабр

В Microsoft Outlook начал пропадать… курсор
26.02.2026 12:30:05 | ferra.ru

Голландские ученые разогнали ИИ благодаря российскому датасету
26.02.2026 12:18:31 | it-world

Отчёт Ozon за год: компания сократила убыток с 59,4 млрд рублей до 938 млн рублей
26.02.2026 12:11:43 | vc.ru

Разработка аркадной гонки на Rust с нуля. Ошибки и успехи
26.02.2026 12:10:46 | Хабр

Безопасность данных в здравоохранении: что поменяется с 1 марта 2026 года
26.02.2026 11:59:57 | Хабр

Молчание не ягнят
26.02.2026 11:58:38 | Хабр

[Перевод] «Обучение на опыте» для малых моделей: переносим методы Physical Intelligence на ACT без использования VLA или диффузии
26.02.2026 11:51:03 | Хабр

Сколько налогов «реально» уходит с зарплаты: Россия vs США на примере 100 000 ₽
26.02.2026 11:29:28 | Хабр

FinOps на практике: фаза Inform и управление облачными затратами с помощью штатных инструментов
26.02.2026 11:26:33 | Хабр

«Контекст 1M» больше не нужен. Как линейные RNN и Titans меняют архитектуру ИИ
26.02.2026 11:18:16 | Хабр

Регистрация ПО в Роспатенте и Минцифре: что это даёт разработчику и бизнесу в 2026 году
26.02.2026 11:16:05 | Хабр

Как мы внедряли ядро ВКС IVA в инфраструктуру Заказчика
26.02.2026 11:15:56 | Хабр

Veai 5.5: поддержка SKILLs, режимы агента Plan и Review, авторевью и ограничение зоны редактирования
26.02.2026 11:11:31 | Хабр

10 процессоров для игр в 2026 году
26.02.2026 11:10:44 | Хабр

СМИ: китайская Meizu свернёт производство смартфонов
26.02.2026 11:09:14 | vc.ru

Мыши, клавиатуры, «вебки»: российский рынок периферии
26.02.2026 11:01:51 | it-world

Как мы превратили каталог процессов в «цифрового сотрудника» на LLM и low-code
26.02.2026 10:59:59 | Хабр

Смотреть все

НОВОСТИ

Четыре города и три района Крыма остались без света
02.07.2026 11:18:39 | Life.ru

Писториус обеспечил себя водой и продовольствием на случай войны
02.07.2026 11:18:26 | Lenta.ru

Яркая практика модернизации сельского хозяйства с китайской спецификой - личи из провинции Гуандун
02.07.2026 11:18:00 | Российская Газета

Лавров уверен, что в Японии есть сторонники диалога и сотрудничества с Россией
02.07.2026 11:17:27 | ТАСС

«Спартак» отказал «Севилье» в аренде форварда Угальде
02.07.2026 11:17:09 | Life.ru

В Петербурге задержали технического пособника мошенников с Украины
02.07.2026 11:16:54 | ТАСС

ЕК пообещала Еревану €38 млн и открытие рынка ЕС для 80% армянских товаров
02.07.2026 11:16:24 | ТАСС

Янтарный самородок с насекомыми внутри и весом 1,55 кг добыли в Калининграде
02.07.2026 11:15:30 | Life.ru

В Поморье в ДТП пострадали шесть человек
02.07.2026 11:14:53 | ТАСС

43-летняя Сати Казанова раскрыла отношение к старению и пластике
02.07.2026 11:13:57 | Lenta.ru

Названа доля использующих ИИ в учебе студентов
02.07.2026 11:13:09 | Lenta.ru

Жительницу КБР обвинили в незаконных розыгрышах в мессенджере на 6,3 млн рублей
02.07.2026 11:13:07 | ТАСС

В Евросоюзе начнут наказывать за публикацию видео российского канала
02.07.2026 11:13:00 | Lenta.ru

«Зелёные ботинки» обретут покой: Служившее ориентиром 30 лет тело альпиниста покинет Эверест
02.07.2026 11:12:45 | Life.ru

Марки изгнали Максимов из списка самых модных у москвичей имён
02.07.2026 11:12:33 | Life.ru

Появились подробности о возможной зацепке в деле пропавшей семьи Усольцевых
02.07.2026 11:12:16 | Lenta.ru

Пашинян надеется на безвиз между Арменией и ЕС к 2029 году
02.07.2026 11:12:03 | ТАСС

В Коми начали проверку после сообщений об инфекции в детских садах
02.07.2026 11:11:48 | ТАСС

После ночной атаки БПЛА нижегородцам открыли горячую линию: куда обращаться
02.07.2026 11:11:42 | Life.ru

СК завел дело после обрушения перекрытия в подвале дома в Петербурге
02.07.2026 11:11:03 | ТАСС

Сборную США по футболу к пробитию пенальти готовили ученые-нейрофизиологи
02.07.2026 11:11:00 | Российская Газета

"Сбермобайл" начал предупреждать близких пользователя о звонках мошенников
02.07.2026 11:10:26 | ТАСС

Создание мощных квантовых компьютеров на нейтральных атомах упростили
02.07.2026 11:09:58 | ТАСС

В Тюмени пропала девочка
02.07.2026 11:09:50 | ТАСС

Зоозащитники вступились за редчайших хищников-людоедов
02.07.2026 11:09:39 | Lenta.ru

Пашинян и Мишустин договорились продолжить обсуждение вопросов двусторонней повестки
02.07.2026 11:09:26 | ТАСС

«Катя, возьми телефон»: Российские уфологи расшифровали систему общения инопланетян
02.07.2026 11:08:25 | Life.ru

Стасишин предложил исследовать отношения банков с застройщиками
02.07.2026 11:08:24 | ТАСС

В Нижнем Тагиле объем паводковых вод пошел на спад
02.07.2026 11:08:19 | ТАСС

Обломки сбитых ночью БПЛА упали в Лужском районе Ленобласти
02.07.2026 11:08:13 | Life.ru

ABC: под угрозой экстремальной жары оказались порядка 160 млн жителей США
02.07.2026 11:07:45 | ТАСС

В Алтайском крае в ДТП погиб человек
02.07.2026 11:07:34 | ТАСС

В Подмосковье подростку предъявили обвинение за поджог на МЖД
02.07.2026 11:06:54 | ТАСС

Politico: дипслужба ЕС оказалась неспособной выстраивать диалог с третьими странами
02.07.2026 11:06:54 | ТАСС

Продажи «АвтоВАЗа» взлетели
02.07.2026 11:06:43 | Lenta.ru

Все новости

ВСЕ НОВОСТИ

ПИШИТЕ

Техническая поддержка проекта ВсеТут

info@vsetut.pro