Как мы сделали автогенерацию документации для CI/CD из комментариев в коде

12.05.2026 06:40:27 | Хабр

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

Привет, Хабр! Меня зовут Николай Чурянин, я занимаюсь iOS-разработкой в ПСБ. Сегодня я хочу рассказать вам, как делал новую документацию для нашего модуля CI/CD. Конечно же, документация у нас была и раньше. И даже не одна — а это, как понимаете, только усугубляло проблему. Часть документации лежала в readme-репозитории — с него-то она по сути и началась. Но обновлялась она там нерегулярно, оказалось, что работать с ней было не очень-то удобно. В какой-то момент этот репозиторий перестали поддерживать, и я попытался оформить её на внутреннем портале. Увы, пользы от этого стало ещё меньше: там документация была оторвана от кода — от наших скриптов. Вдобавок, её было трудно обновлять. Надо ли говорить, что и её забросили?

«Совсем без документации тоже нельзя», — решил я и принялся искать другой способ. И нашёл его (спойлер: без ИИ тут не обошлось). Покажу, что получилось и как всё теперь работает.

Подробнее

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

Как исчезнуть из интернета
12.05.2026 06:31:26 | Хабр

GPU Compute Engine для 1С: как перестать ждать часами и начать считать на видеокарте
12.05.2026 06:30:44 | Хабр

Стратегия бизнеса. 12 граблей и что делать вместо
12.05.2026 06:20:24 | Хабр

ClickHouse не тормозит, но не умеет в DML. Часть 1. Мутации
12.05.2026 06:20:22 | Хабр

Почему бенчмарки в AI сломались — и что с этим делать в понедельник
12.05.2026 06:15:17 | Хабр

BLE для Arduino: пишем команды, а не дескрипторы
12.05.2026 06:12:15 | Хабр

«Продай мне этот космолёт» или история любви к симуляторам. От космосима X-Tension до ActorModel/DoD/ECS архитектуры. Ч1
12.05.2026 06:00:12 | Хабр

[Перевод] 8. Проектирование с помощью типов: Заключение
12.05.2026 06:00:12 | Хабр

Извлечение и обработка требований из документов с помощью NLP-инструментов
12.05.2026 06:00:11 | Хабр

SmileLadder. Цикл «Память и мозг». От маятников до нейронов или как модель Курамото может показать синхронизацию
12.05.2026 05:41:06 | Хабр

Эра персональных приложений
12.05.2026 05:30:04 | Хабр

Мне надоело искать ошибки глазами — я создал бесплатный аудитор для 1С
12.05.2026 05:28:01 | Хабр

Как я собирал рабочее окружение для ИИ-разработки
12.05.2026 05:27:06 | Хабр

Без документации ИИ далеко не уедет: мои грабли на проекте
12.05.2026 05:26:54 | Хабр

ИИ может писать код, но умеет ли он делать красиво? Мой опыт с виджетом и аватарами
12.05.2026 05:26:43 | Хабр

Вайбкодинг как управляемая разработка на примере личного опыта
12.05.2026 05:24:47 | Хабр

Я держу 4 Claude-инструмента в работе. HBR говорит, что у таких brain fry. Я был среди них
12.05.2026 05:00:53 | Хабр

Запустил AI-репетитор английского месяц назад: технические грабли соло-дева
12.05.2026 03:51:39 | Хабр

Как я доказал гипотезу Коллатца (3n+1) без математики
12.05.2026 01:38:14 | Хабр

Planulix: как я собрал центр управления для Claude Code, Cursor, Codex и Kimi на своих проектах
12.05.2026 01:26:31 | Хабр

Widlet — pet-проект про Server-Driven UI на Dart
12.05.2026 00:16:40 | Хабр

GoBlend — мост между BLENDER и GODOT
11.05.2026 22:58:07 | Хабр

Хакеры воспользовались рекламой в Google, чтобы заражать ПК жертв
11.05.2026 22:55:46 | ferra.ru

Ollama и Open WebUI на VPS без GPU: рабочий вариант или боль?
11.05.2026 22:53:12 | Хабр

Видео со стадиона через нейросеть: как повторить ИИ-тренд TikTok 2026 с кадром прямой трансляции
11.05.2026 22:20:29 | Хабр

Что покупают на Авито в мае? Спойлер: не только ветровки и мангалы
11.05.2026 22:07:04 | Хабр

Энтузиаст создал Muxcard — компьютер размером с банковскую карту
11.05.2026 20:55:48 | ferra.ru

Нейросети-Художники. ChatGPT в этой роли
11.05.2026 19:43:30 | Хабр

Меня раздражает, как объясняют асинхронность
11.05.2026 19:34:31 | Хабр

Когда «просто проведи кастдев» — худший совет
11.05.2026 19:14:07 | Хабр

Почему классический подход к QA больше не работает (и виновата ли в этом эпоха ИИ)
11.05.2026 19:10:04 | Хабр

Инсайд: Vivo и Honor выпустят широкие складные смартфоны
11.05.2026 18:55:49 | ferra.ru

Легко ли навайбкодить новый «Черный квадрат»?
11.05.2026 18:30:59 | Хабр

Производитель чипов Cerebras увеличил ценовой диапазон IPO — он собирается привлечь до $4,8 млрд при капитализации в $48,8 млрд
11.05.2026 18:11:03 | vc.ru

Использование машинного обучения в работе с SolidWorks (1 часть)
11.05.2026 17:45:53 | Хабр

Смотреть все

НОВОСТИ

Офицер Кортес: основная сила ВСУ отошла из Красного Лимана
14.07.2026 13:17:04 | ТАСС

В Уфе пострадавшим от атак БПЛА будут выплачивать материальную помощь
14.07.2026 13:16:17 | ТАСС

Звезда сериала «ГДР» назвала Гузееву сумасшедшей актрисой
14.07.2026 13:16:11 | Lenta.ru

КС определил срок оспаривания архивной кадастровой стоимости недвижимости
14.07.2026 13:15:51 | ТАСС

Женщина ранена в Шебекино при взрыве дрона ВСУ
14.07.2026 13:15:41 | Life.ru

Мантуров прибыл на космодром Байконур
14.07.2026 13:14:46 | ТАСС

В Северной Осетии учредили новое высшее звание для педагогов
14.07.2026 13:14:05 | ТАСС

Фетисов: благодаря Куклевой российский женский биатлон был на лидирующих позициях
14.07.2026 13:14:02 | ТАСС

Трамп отверг версию о причастности России к смерти сенатора Линдси Грэма*
14.07.2026 13:12:53 | Life.ru

Умер бывший глава избиркома Петербурга Виктор Миненко
14.07.2026 13:12:39 | ТАСС

«Как хождение на каблуках»: Ветеринар объяснила, почему собакам и кошкам нужно стричь когти
14.07.2026 13:12:27 | Life.ru

Российский военнослужащий рассказал об одной категории солдат на фронте
14.07.2026 13:12:09 | Lenta.ru

Цены на нефть достигли месячного максимума
14.07.2026 13:11:19 | Lenta.ru

Семин считает, что победитель матча между сборными Франции и Испании выиграет ЧМ
14.07.2026 13:11:10 | ТАСС

В Белгородской области женщина ранена из-за детонации дрона ВСУ
14.07.2026 13:11:08 | ТАСС

Песков: Россия адаптировалась к десяткам тысяч санкций
14.07.2026 13:10:29 | Life.ru

В Карелии на поиски пропавших детей выехали около 10 добровольцев
14.07.2026 13:09:56 | ТАСС

Софинансирование получили 7,8 млн вкладчиков программы долгосрочных сбережений
14.07.2026 13:09:44 | ТАСС

Олимпийская чемпионка по биатлону Куклева до последних дней работала в вузе
14.07.2026 13:09:26 | ТАСС

Неизвестная ракета ударила по танкеру у берегов Омана
14.07.2026 13:08:45 | Life.ru

Гражданина Украины будут судить за повреждение могил участников СВО в Краснодаре
14.07.2026 13:08:23 | Коммерсантъ

Российский легкомоторный самолёт «Танго» успешно совершил первый полёт
14.07.2026 13:08:10 | Life.ru

ФАС призывает крупнейшие сети ограничить цены на школьные товары
14.07.2026 13:08:09 | Life.ru

Президент IBU Далин назвал Куклеву выдающейся спортсменкой
14.07.2026 13:07:56 | ТАСС

Боец ВС РФ: военнослужащие получают премию за каждый сбитый БПЛА
14.07.2026 13:07:05 | ТАСС

Россиянам дали советы по выбору украшений при ограниченном бюджете
14.07.2026 13:06:21 | Lenta.ru

Рискующий потерять кресло Фёдоров насолил серьёзным людям, утверждает его советник
14.07.2026 13:06:03 | Life.ru

Кремль ответил на заявление Мерца о гарантиях безопасности для Украины
14.07.2026 13:06:01 | Lenta.ru

В Бурятии начали проверку после нападения супружеской пары на врача-гинеколога
14.07.2026 13:05:34 | ТАСС

В Красноярске проверят арестованного педофила на причастность к другим преступлениям
14.07.2026 13:04:02 | ТАСС

Кремль не станет портить отношения с Баку из-за разногласий по Украине
14.07.2026 13:03:41 | Life.ru

Россиянам объяснили, как не попасться на уловки фейковых приложений
14.07.2026 13:03:32 | Life.ru

Пассажиры российской авиакомпании застряли в Армении
14.07.2026 13:02:54 | Lenta.ru

Антимонопольный регулятор Швейцарии начал расследование против Google
14.07.2026 13:01:59 | ТАСС

Умер хоккейный арбитр, работавший на двух матчах Суперсерии-1972
14.07.2026 13:01:07 | ТАСС

Все новости

ВСЕ НОВОСТИ

ПИШИТЕ

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

info@vsetut.pro