RU

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

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

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

От набора PDF-файлов до портала технической документации на 2,5 тысячи статей

В этой статье мы расскажем, как развивали систему документации, сохранив за техническими писателями привычный инструмент, какие трудности возникли с п…

deltadesignmkdocsxslthelpдокументация
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 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