Как я собрал базу знаний и почему команда до сих пор ей активно пользуется
Записать полезную информацию на салфетке, в чате или комментарии к задаче точно лучше, чем сразу же забыть. Однако может наступить момент, когда «са…
Latest News
⚑ Report a ProblemTech news from the best sources
All topics
- игры
AI
News
Tech
agents
ai
api
architecture
automation
backend
beginners
career
devchallenge
devops
javascript
llm
machinelearning
mcp
opensource
performance
productivity
programming
python
react
security
showdev
testing
tutorial
typescript
webdev
[Перевод] Я не хочу читать то, чего вы не писали
Инженер Колин Брек устал читать дизайн-доки, описания PR, тикеты и письма, сгенерированные ИИ. При этом ему самому ИИ помогает писать: недавно он за…
МАЯК: сначала документация, потом кнопки
Я собрал конвейер «ТЗ → канонизация → тест-дизайн → прогон» из 58 специализированных блоков с гейтами доверия: каждый критерий приёмки заземляется ц…
Markdown, который вы не замечали: от двух пробелов до интерактивной статьи
Я собирался написать статью про Markdown. В процессе внутри документа оказался Doom. Разбираемся, почему два пробела меняют перенос строки, обратные…
Аналитик и ИИ: три инструмента, которые превращают хаос в требования
Мы работаем на крупном проекте, где присутствует десятки интеграций, сотни бизнес-сценариев, документация в Confluence, а теперь ещё и описания бизн…
Алгоритм терморегулирования в серверных процессорах Intel
При эксплуатации сервера пользователь сталкивается сразу с несколькими показателями температуры процессора. У него возникает ряд вопросов: какие из…
Docs-as-code для медицинских систем: как перевести 1160 страниц из MS Word в Asciidoctor и автоматизировать сборку
Вам в наследство досталось руководство пользователя МИС на 1160 страниц в формате .docx, тысячи повторяющихся скриншотов, процесс обновления вызывае…
Как документировать API: частые ошибки и лучшие практики для создания своего руководства
Через дата-инженеров Далее проходят десятки описаний интеграций в совершенно разных форматах, даже в Excel. Формально такая API-документация есть, н…
Как я облегчил свою жизнь в работе Аналитика 1С
В работе аналитика 1С хватает задач, которые находятся между обсуждением потребности заказчика и разработкой: оформить требования, проверить св…
Фронтенд и бэкенд работают отдельно. Как я связал их задачи через OpenSpec
«Посмотри эти коммиты, потом ещё вот этот фикс» — сколько раз вы так вводили AI-агента в курс командной задачи? Я организовал OpenSpec так, чтобы фр…
В вайбкодинге агент почти не читает документацию без ссылки: 57 файлов из 88 он не открыл ни разу
В вайбкодинге документацию первым читает агент, и открывает он почти только то, на что ему сослались. По журналам Claude Code одного моего проекта ф…
Как мы создаём ИИ-агента для технических писателей (и почему это непросто)
Привет, на связи команда документирования СберТеха и авторы этой статьи — Маша Бурханова, Лида Ковач и Саша Яковлев. Мы уже рассказывали , как созда…
110 тестов, которые не проверяют код: как заставить документацию падать вместе со сборкой
В своей же справке я нашёл фразу, которая была неправдой. Не устарела - была неправдой с самого начала. Дальше про то, как сделать так, чтобы кодова…
Почему ИИ для программирования выбирает одни и те же библиотеки: я просканировал 30 сайтов документации
Я собираю фидбэк по проекту, который советую людям как альтернативу тяжёлому фреймворку. Вставляю его в диалог с ассистентом кода и прошу подсказать…
ИИ делал за поставщиков их работу и жёг токены. Пришлось сделать его тупее
Меня зовут Никита Мохов. Я отвечаю за цифровое развитие закупок, документооборот и ещё десяток процессов в Цифровом СИБУРе – начиная с закупок и до…
RAG, поиск и LongContext: почему сложные пайплайны не всегда нужны
В 2023 году RAG был единственным способом засунуть знания в LLM — контекстное окно было маленьким, часто были галлюцинации. RAG постепенно стал одно…
[Перевод] ИИ для передачи дел: как найти знания, которые уходят из компании вместе с техлидом
Документация редко отражает всю картину проекта. Самые важные решения часто остаются в переписках, памяти команды и привычках одного человека. На пр…
SpecaFlow — больше чем SDD
Вайбкоддинг быстро обнажил своё главное слабое место. Как только у проекта появляется реальный потребитель, встаёт вопрос ответственн…
Как я держу документы и инструкции для агентов в актуальном состоянии
Цепочка такая: Сессия заканчивается. Транскрипт остаётся на диске. Хук SessionEnd только ставит session_id в очередь ( enqueue ). Текст уроков он не…
Как мы автоматизировали перевод технической документации через инструменты вокруг модели
Рассказываем, как мы автоматизировали перевод технической документации и построили отдельный слой вокруг LLM, который выполнял главную работу. Читат…
Миграция Power BI → Apache Superset: что переносится на самом деле
На Apache Superset я перенёс один отчёт. Одна таблица, пара графиков, день работы. Это была годовая цель: показать, что умею. Пользуются при этом по…
Виртуальные сотрудники вместо ИИ-помощников: как агенты учатся работать внутри компании
Разработка постепенно меняет привычное разделение работы между человеком и инструментами. ИИ берет на себя не отдельные операции, а последовательнос…
DokuWiki как платформа для технической документации: наш опыт
Когда технической документации становится много, она перестает быть просто набором инструкций и справочных материалов. Она превращается в базу знани…
README врёт: как я сделал open‑source линтер, который сверяет документацию с реальным репозиторием
README редко ломается в один момент. Обычно он просто постепенно перестаёт соответствовать проекту: переименовали команду, перенесли файл, удал…
Мы мигрировали сотню страниц документации через MCP-сервер, а не скриптами
У каждого опубликованного сайта GitBook уже есть MCP-сервер. Мы узнали об этом случайно и вместо конвертеров просто дали агенту ходить в документаци…
Как мы описали 15 000 таблиц за полгода вместо 500 за год — и перестали писать документацию руками
Годы идут, но что‑то остаётся неизменным: писать документацию никто не любит, но тем не менее все почему‑то ругают тех, кто её н…
[Перевод] Вашему ИИ‑агенту нужна карта: LLM Wiki или README достаточно
В своей предыдущей статье об инструментах и агентах искусственного интеллекта я рассмотрел инструменты, которые меняют подход к разработке програм…
Как QA я все равно пишу документацию, но с ИИ трачу на нее часы, а не дни
В статье я расскажу, как решал проблемы погружения в проект сначала вручную, а потом с помощью ИИ-инструментов и как мне удалось сократить путь от д…
Как мы показываем клиентам документацию по проекту из приватного репозитория, не пуская их в репозиторий
Сразу дисклеймер: это рассказ про инструмент, который мы написали для себя и используем каждый день. Ссылку дам в конце, продавать не буду — расскаж…
Одна ошибка, и ты ошибся: как сохранить доверие к ИТ-продукту
Привет, Хабр! Меня зовут Мария, я технический писатель в ИнфоТеКС. Представьте: вы запускаете новое приложение, тщательно проработанное, с инновацио…