RU

От хаоса к порядку: как и зачем мы перешли на модифицированную архитектуру ведения Git

И снова привет, Хабр! Я Артем Клещев, технический писатель в СберТехе. Недавно я рассказал , как построить удобную архитектуру репозитория продукта и …

сбертехplatform vdropappдокументациядокументированиеdocs-as-codegitархитектура
Habr
RU

Всё есть код, или зачем внедрять GitOps в разработку

Привет, Хабр! Сегодня мы часто говорим про разные тренды в разработке — ИИ-агентов, тестирование на ранних стадиях, прослеживаемость изменений, автома…

ci cdci cd пайплайныgitopsgitops-практикидокументациядокументация проекта
Habr
RU

Когда Claude Code ошибается не по своей вине: документационный долг в соло-проектах

У соло-разработчика CLAUDE.md устаревает быстрее кода. Через пять-шесть итераций фич он начинает уверенно врать, и Claude верит ему, потому что у него…

claude-codellmдокументацияclaudeтехнический-долг
Habr
RU

«Боргворглер: боргает ворглер», или как сделать действительно полезную документацию к проекту

Обсуждения неудачных примеров README-файлов и документации — одна из популярных тем на профильных площадках и форумах [вкупе с другими «вечнозелеными»…

beeline cloudдокументацияreadmeподготовка документациидокументирование кода
Habr
RU

Когда онбординг длится 2 месяца: день 3 — проследить главный поток данных

Иногда систему нужно быстро объяснить человеку со стороны: новому разработчику, техлиду, архитектору, аудитору или инвестору на technical due diligenc…

онбордингdata flowархитектурадокументацияUMLAPISDKdebugginglegacyрефакторинг
Habr
RU

Пользователь, they и Шекспир: история одного скандала

“User — это не he. User - это they. Аккуратно с этим в международных командах”. На днях из-за этой короткой заметки в моих соц. сетях разразился насто…

английский языкдокументацияанглийскийанглийский язык изучениеанглийский язык самообразованиеанглийский обучение языкианглийский язык онлайнанглийский онлайниностранные языкииностранный язык
Habr
RU

Код как документация: как мы строим самодокументируемые витрины данных в Почте Mail

В аналитике больших данных есть старая проблема: код ETL-витрин живет своей жизнью, а документация — своей. Изменяешь логику, забываешь обновить описа…

big dataapache sparkairflowclickhousesqlдокументацияdwhmetadatadbtvk tech
Habr
RU

Код как документация: как мы строим самодокументируемые витрины данных в Почте Mail

В аналитике больших данных есть старая проблема: код ETL-витрин живет своей жизнью, а документация — своей. Изменяешь логику, забываешь обновить описа…

big dataapache sparkairflowclickhousesqlдокументацияdwhmetadatadbtvk tech
Habr
RU

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

Привет, Хабр! Меня зовут Николай Чурянин, я занимаюсь iOS-разработкой в ПСБ. Сегодня я хочу рассказать вам, как делал новую документацию для нашего мо…

ci cdдокументациядокументация проектадокументация это легкоииии и машинное обучение
Habr
RU

Без документации ИИ далеко не уедет: мои грабли на проекте

На этой неделе я побывал в клубе AI Practiq, где ребята собираются, обсуждают вайбкодинг , делятся опытом и практиками. Один из участников рассказывал…

практика программированияискусственный интеллектвайб-кодингвайб-программированиевайбкодингвайб-кодвайб кодингвайбокодингобмен опытомдокументация
Habr
RU

Когда онбординг длится 2 месяца: день 2 — карта репозиториев

Представьте: ваш первый день в офисе, вам дали доступы ко всем 15 репозиториям проекта, рассказали где что лежит, и теперь ждут от вас великих дел. Те…

онбордингrepository mapсистемный анализархитектурадокументацияdependency matrixdata flow
Habr
RU

Разбор реализации docs-as-code на базе Sphinx

Привет, Хабр! Меня зовут Артём Зеленкин, приятно познакомиться! Я работаю техническим писателем около 20 лет, сейчас занимаюсь документированием …

документациятехнический писательтехписподготовка документацииinfowatchARMA
Habr
RU

Veai 5.10: общие скиллы и подсказки в чате

Главное в Veai 5.10 – скиллы теперь подхватываются из dot-директорий других ассистентов. В чат добавили быструю документацию по ссылкам на код. Запуск…

ai-агентыllmавтоматизация тестированиягенерация кода aiавтоматизация разработкиai в разработкеавтоматическая генерация кодаии-ассистентintellij idea pluginдокументация
Habr