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

Как мы потеряли GitBook за 5 минут и нашли Gramax — open-source альтернативу, которую теперь используем сами

Пишет об этом Product Manager команды: Котельникова Екатерина Андреевна.

Вася уволился — и унёс с собой 80% знаний о системе

Однажды утром вы открываете задачу и понимаете: единственный человек, который знал, как это работает, вчера уволился. Знания ушли вместе с ним. Всем привет, я Артём Герасимов, владелец продукта SimpleOne SDLC. Сегодня поговорим о проблеме, с которой сталкивалась, наверное, каждая ИТ-команда: уходит ключевой разработчик — и вместе с ним испаряется всё, что он знал о системе. […]

Нужен ли синопсис технической документации? Личный опыт разработки

Разработка документации на создаваемые ИТ-продукты – это не только «правила хорошего тона», но и насущная необходимость. Ведь без технического задания невозможно зафиксировать требования к продукту, без руководства пользователя сложно грамотно продуктом пользоваться, без технической документации, описывающей продукт, сложно будет искать и исправлять ошибки и проводить необходимые доработки, когда в них возникнет необходимость, и т.д.

Как правильно оформлять РИДы в ИТ-проектах, чтобы не создавать спорных ситуаций

В разработке проектов всегда необходимо выделять все результаты интеллектуальной деятельности. Особенно если к процессу подключены сразу несколько подрядчиков.  Сайт или приложение — это комплексный РИД, который состоит из множества объектов. Каждый из них охраняется законом об интеллектуальной собственности. Клиент должен быть уверен, что может свободно распоряжаться всеми объектами. И понимать — к кому обратиться за […]

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

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

11 сервисов для замены Confluence в 2026 году

В 2025 году Atlassian объявила о фокусе на облачной модели и постепенном сворачивании серверных решений. С марта 2026 года прекращается продажа новых лицензий, затем начнется поэтапное отключение обновлений и технической поддержки. Полный переход запланирован на конец марта 2029 года. Отключение поддержки on-premise решения означает, что компаниям придется либо переходить в облако, либо искать замену. В […]

Что раздражает коллег, но никто об этом не говорит: 8 вредных привычек в ИТ

Автор: Иван Богданов, Технический писатель  Материалов про эффективную коммуникацию в командах — море. Про SMART-цели, agile-ретроспективы, feedback-сессии написано столько, что можно диссертацию защитить, да и не одну, но я хочу подойти к проблеме внутрикомандной коммуникации с другой стороны. Вместо методик и best practices поговорим о том, что не надо делать в реальном общении внутри команд, […]

Где вести базу знаний: 8 российских сервисов и их возможности

Когда в команде больше 5 человек, ссылка на папку с документами перестает работать. Ну, или как минимум становится просто неэффективной. Файлы дублируются, версии путаются, половина инструкций устаревает. Поэтому мне захотелось посмотреть и разобрать российские сервисы для базы знаний — с ценами, ограничениями и честными плюсами/минусами. Подробнее о них — в статье ниже. Что такое база […]

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

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

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

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

123.4