RU

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

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

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

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

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

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

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

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

проектирование apiмашина тьюрингарефакторингjavascriptдизайн-ревьюдокументация
Habr
RU

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

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

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

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

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

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

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

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

онбордингdata flowархитектурадокументацияUMLAPISDKdebugginglegacyрефакторинг
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