Подготовка технической документации.

Стандарт Simplified Technical English и перевод технической документации

Привет, Хабр! Сегодня хотелось бы поднять актуальную тему – перевод технической документации и то, как стандартизированный английский язык может существенно упростить этот процесс.Техническая документация чаще всего пишется на английском языке. Документацию используют международные команды и на ее основе создаются переводы и обновляются новые версии инструкций.

продолжить чтение

Интересные кейсы про ADR + ИИ

Всем привет! Меня зовут Катя, я развиваю Gramax — базу знаний для ИТ-команд. Мы в команде давно и настойчиво говорим об одном: документация — это не довесок к разработке, это ее часть. Писать доку нужно до кода, вместе с кодом, а не после — когда контекст уже размылся, а решения давно забыты. Считаем, что это инженерная культура, без которой появляется куча проблем: медленный онбординг, повторяющиеся споры об уже принятых решениях, техдолг.

продолжить чтение

Как редактору повысить качество ответов RAG-поиска

Всем привет! Меня зовут Катя, я развиваю Gramax — базу знаний для ИТ-команд.В Gramax мы делаем упор на качественную работу как человека, так и машины. И часто получаем вопросы, как автор статей может повлиять на качество выдачи ИИ-поиска. В большей мере качество поиска зависит от нас: мы регулярно улучшаем внутренние механизмы, чтобы авторы не становились заложниками технологий. Но есть универсальные правила, которые работают в любой системе с RAG. Этими правилами и хотим поделиться в этой статье:)Основной принцип

продолжить чтение

В Debian отказались принимать решения по поводу вкладов в код от ИИ

В Debian решили не принимать документ по вкладам, сгенерированным ИИ. Обсуждение темы началось в феврале 2026 года и выявило множество нюансов, но в итоге не привело к голосованию по общей резолюции (GR).

продолжить чтение

А как насчёт дрейфа?

В ответ на статью: Анализ договорных рисков при помощи искусственного интеллектаК сожалению, в представленной статье на Хабре темы дрейфа модели и ее регулярные обновления напрямую не рассматриваются. Авторы подробно описали архитектуру пайплайна, но не затронули стратегии долгосрочной стабильности системы.Рекомендации авторам статьи1. Внедрить систему мониторинга дрейфа моделиТекущая ситуация: У вас отличный экспериментальный протокол (dev/val/test), но он используется на этапе разработки, а не для постоянного мониторинга.

продолжить чтение

Как мы строили своего AI-агента для генерации тестовой документации — опыт QA-команды мобильных секретарей

Привет, Хабр! На связи QA-команда мобильных секретарей — Настя и Ксюша.

продолжить чтение

Как ИИ меняет отношения к документам в работе

Помните момент, когда вы впервые попробовали ChatGPT или GitHub Copilot? У меня это было похоже на взрыв: привычные процессы рухнули, а на их месте начала формироваться новая реальность.У меня был похожий опыт. Ещё в 2022‑м (как только был выход из бета‑тестирования и запуск по подписке), поставив эксперимент с GitHub Copilot среди сотрудников, я увидел, как меняется скорость разработки и как опытным разработчикам помогает а джунов ставит только в тупик. Но главное открытие ждало впереди: ИИ не просто ускоряет работу — он заставляет переосмыслить сам подход к хранению и обработке информации.

продолжить чтение

1Yes: выпустили ТЗ-машину для 1С. И даём финансовую гарантию

Коротко: мы выпустили функционал, которого ждали наши пользователи – автоматическая подготовка технического решения и спецификации для разработчика без галлюцинаций. Покажу на реальном примере.Как это работаетАналитик описывает задачу. 1Yes берёт конфигурацию 1С – со всей её кастомизацией, самописными объектами и многолетними наслоениями – и делает следующее:Шаг 1. Два технических решения с разбором.

продолжить чтение

Технарь пишет статью с AI: пайплайн, слои и чеклист

Вы проектировали системы, которыми пользуются тысячи людей. Разбирались в инцидентах, от которых зависел бизнес. Знаете вещи, не описанные ни в одной документации. Но статью на Хабр — не написали. Потому что «не умею писать», «не хватает времени на оформление», «получается сухо и скучно».AI меняет эту ситуацию. Не «пишет за вас» — помогает превратить экспертизу в читабельный текст. Но между «скормил тезисы в ChatGPT» и «написал сильную статью с помощью AI» — огромный путь. Эта статья — о том, как его пройти.

продолжить чтение

От монолога к диалогу: как «Три амиго» научили нас сверять карты перед стартом

Привет, Хабр! Я являюсь тестировщиком компании TravelLine. Мы разрабатываем единую систему для гостиничного предприятия, которая помогает отелям, санаториям и другим средствам размещения автоматизировать свои бизнес-процессы. В этой краткой статье (я бы назвал её отзывом на инструмент) я не буду рассказывать о концепции встреч в формате “3 Амиго”, хочу лишь поделиться личным опытом внедрения таких сессий в процесс разработки требований в одной из своих команд.

продолжить чтение

Rambler's Top100