Архив рубрики ‘документация проекта’

Генеральная уборка базы знаний: плюсы, подводные камни, минусов не будет

Привет, Хабр. Меня зовут Мария Рылик, я — старший контент-менеджер группы управления пользовательским опытом веб-поддержки «Лаборатории Касперского». И полтора года назад я столкнулась с распространенной в техписовских кругах проблемой: децентрализованной базой знаний. Чтобы найти инфу по работе с конкретным продуктом, приходилось по крупицам искать ее в разных статьях, в большинстве своем имеющих мало общего с […]

Размышления о документации

Вряд ли найдётся кто-либо, кто в здравом уме и ясной памяти будет отрицать необходимость документации. Любой продукт имеет (или должен иметь) свою документацию. Как минимум – инструкцию о том, как этим продуктом пользоваться. Производители почти всегда указывают – «прежде чем начать пользоваться нашим продуктом, внимательно ознакомьтесь с инструкцией».  

Секреты передачи знания: переход границ опыта при уходе ключевых инженеров и документирование архива проектов

Каждый разработчик рано или поздно сталкивается с ситуацией: из команды уходит «тот самый» человек, который держал в голове половину архитектуры. Вместе с ним уходит не только опыт, но и часть будущего проекта. В статье делюсь мыслями и подходами, как минимизировать потери при передаче знаний, какие форматы работают, а какие — нет, и почему документация должна […]

TDMS Фарватер Web: смотрите онлайн-премьеру 30 сентября

Приглашаем на премьеру TDMS Фарватер Web – новой системы с удобным веб-интерфейсом для документооборота и управления проектированием в строительстве. Изображение

Безумству храбрых… Как заставить ИИ понимать нормативные требования для проверки ЦИМ

Сгенерировано AI Прошло целых два года, как команда NSR Specification твердо пообещала добиться автоматизации экспертизы цифровых информационных моделей

Разработка требований к ПО с помощью Markdown, Git и Obsidian

Привет из ада трассировки требований В предыдущей статье автор сформулировал набор принципов организации хранения и оформления документации ПО, позволяющих преодолеть пропасть между требованиями верхнего уровня (ТВУ) бизнеса к программному продукту и требованиями нижнего уровня (ТНУ) к программному коду, а именно: Каждое требование записывается в отдельный файл в формате Markdown.

Как применять чат-ботов с LLM для решения простых офисных задач

Предисловие Добрый день, уважаемые читатели! Не так давно я проводил внутрикорпоративное мероприятие о том, как правильно применять чат-ботов, чтобы немного ускорить офисную рутину. Мероприятие очень понравилось аудитории, поэтому я решил переработать презентационный материал в статью — вдруг он принесет пользу еще кому-нибудь?

Системный аналитик против хаоса. Часть 3: Работа с Product Owner’ом и управление изменениями

Проекты практически никогда не развиваются линейно. Они меняются под влиянием внешней среды, новых данных, пользовательского поведения и приоритетов бизнеса. В этой динамике PO — один из ключевых элементов. Его задача быть гибким, оперативно реагировать на внешние сигналы и адаптировать продукт под текущую реальность. Однако именно из-за этой гибкости его действия часто воспринимаются как импульсные, непредсказуемые […]

От Docs as Code к Everything as Code: как Gramax меняет работу с документацией

Привет, Хабр! Меня зовут Катя, я лидирую Gramax, open-source платформу для управления технической документацией. Однажды мы с коллегами утонули в хаосе рабочих документов: без версий, без согласований, без истории принятых решений. Это подтолкнуло нас к созданию Gramax — инструмента, который интегрирует документацию в процесс разработки, делая его прозрачным и управляемым. В этой статье расскажем, как […]

Системный аналитик и управление хаосом на проекте. Часть 1: диагностика хаоса

Представь, что ты пришел на новый проект, который находится в состоянии глубокого информационного хаоса. Требования разбросаны по десяткам файлов, нет протоколов встреч, идеи Product Owner’а меняются слишком быстро, а ключевая информация теряется между переписками в мессенджерах и электронной почтой. К сожалению, так бывает! И попытки сразу перейти к структурированию в текущих условиях — очень большая […]

12