RU

Виртуальные сотрудники вместо ИИ-помощников: как агенты учатся работать внутри компании

Разработка постепенно меняет привычное разделение работы между человеком и инструментами. ИИ берет на себя не отдельные операции, а последовательнос…

виртуальный сотрудникИИ-агентконтексторкестрациякорпоративные знаниядокументацияавтоматизацияМТСпроверка решенийDevRails
Habr
RU

DokuWiki как платформа для технической документации: наш опыт

Когда технической документации становится много, она перестает быть просто набором инструкций и справочных материалов. Она превращается в базу знани…

docuwikiдокументациятехнический писательразработка
Habr
RU

README врёт: как я сделал open‑source линтер, который сверяет документацию с реальным репозиторием

README редко ломается в один момент. Обычно он просто постепенно перестаёт соответствовать проекту: переименовали команду, перенесли файл, удал…

RealityLintREADMEPythonGitHub-ActionsCI-CDopen-sourceстатический-анализдокументациятестированиелинтер
Habr
RU

Мы мигрировали сотню страниц документации через MCP-сервер, а не скриптами

У каждого опубликованного сайта GitBook уже есть MCP-сервер. Мы узнали об этом случайно и вместо конвертеров просто дали агенту ходить в документаци…

MCPAI-агентыдокументацияdocs-as-codeDiplodocGitBookмиграцияmarkdownтехническая документацияYFM
Habr
RU

Как мы описали 15 000 таблиц за полгода вместо 500 за год — и перестали писать документацию руками

Годы идут, но что‑то остаётся неизменным: писать документацию никто не любит, но тем не менее все почему‑то ругают тех, кто её н…

dwhдокументацияаналитика данныхсырые данные
Habr
RU

Как QA я все равно пишу документацию, но с ИИ трачу на нее часы, а не дни

В статье я расскажу, как решал проблемы погружения в проект сначала вручную, а потом с помощью ИИ-инструментов и как мне удалось сократить путь от д…

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

Как мы показываем клиентам документацию по проекту из приватного репозитория, не пуская их в репозиторий

Сразу дисклеймер: это рассказ про инструмент, который мы написали для себя и используем каждый день. Ссылку дам в конце, продавать не буду — расскаж…

документацияdocs-as-codemarkdowngitMCPGitHubGitLabтехническая документациякомментарии к документацииAI-агенты
Habr
RU

Одна ошибка, и ты ошибся: как сохранить доверие к ИТ-продукту

Привет, Хабр! Меня зовут Мария, я технический писатель в ИнфоТеКС. Представьте: вы запускаете новое приложение, тщательно проработанное, с инновацио…

инфотекстхническое писательстводокументация проектадокументация кодадокументация на подокументация itдокументация подокументация
Habr
RU

Корпоративная библиотека как система: Как мы выстраивали архитектуру знаний для нашей IT-команды и что из этого вышло?

Когда команда небольшая и все сидят в одном открытом пространстве, знания передаются почти сами собой — через разговор у кофемашины, ревью кода, общ…

корпоративная база знанийуправление знаниямиConfluenceкорпоративная библиотекадокументацияIT-командаонбординг разработчиковEngineering Managerуправление разработкойархитектура знаний
Habr
RU

Context7 — стандарт для доков AI-агента. Я измерил 8 альтернатив и собрал бесплатную связку

Context7 — мой дефолтный источник свежих доков для агента уже полтора года. И всё устраивало, пока я не начал ловить устаревший код: старый z.string…

MCPContext7neuledgeдокументацияAI-агентыClaude CodeCodexбенчмаркитокеныRAG
Habr
RU

Context7 — стандарт для доков AI-агента. Я измерил 8 альтернатив и собрал бесплатную связку

Context7 — мой дефолтный источник свежих доков для агента уже полтора года. И всё устраивало, пока я не начал ловить устаревший код: старый z.string…

MCPContext7neuledgeдокументацияAI-агентыClaude CodeCodexбенчмаркитокеныRAG
Habr
RU

OpenAPI без #[OA\...]: как я сделал генератор документации для Symfony

В прошлой статье я уже рассказывал, как однажды устроился на работу и получил пачку «интересных» задач: вручную синхронизировать OpenAPI, оформленны…

OpenAPISymfonyPHPSwaggerDTOView objectsAPIдокументацияавтогенерацияroutes
Habr
RU

Браузерный переводчик нашёл «Глубинное государство» в доках веб-фреймворка. Вспомни своё

Сколько раз вы жали «Перевести страницу» на технической документации, не замечая, что читаете уже совсем другой текст? Я заметил — и собрал доказате…

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

Как я использую AI в работе продакт-оунера в EXANTE: от ресёрча до релиза

Как продакт-оунер в Exante выпускает сложные фичи в два раза быстрее благодаря AI — и почему продуктовые решения по-прежнему принимает сама. Читать…

продакт-менеджментпродакт-менеджердокументацияпрототипирование интерфейсовиидискаверикоммуникацияинтервью с клиентамиclaudeclaude code
Habr
RU

Два мажора, один README, одно демо: два почти бесплатных дизайн-ревью

Из трёх мажоров, описанных в предыдущей статье, два не всплыли в тестах. Они всплыли в двух дизайн-ревью, которые тесты про…

проектирование apiмашина тьюрингарефакторингjavascriptдизайн-ревьюдокументация
Habr
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 dilige…

онбординг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