Документация не нужна, пока не уволится… Катя

В каждой команде есть своя Катя. И пока она на месте — кажется, что документация это блажь. При этом Катя единственная знает, почему пару лет назад платёжный модуль написали именно так, почему интеграция с этим контрагентом идёт через костыль, а какие функции в legacy нельзя трогать вообще никогда. Команда привыкла: что-то непонятно — спрашиваем у неё, отвечает за пять минут. Удобно.

Дальше всегда одинаково — сначала такой человек уходит в отпуск, и разработка замедляется, но никто не связывает одно с другим явно — просто спринт получился вялый. Спорные правки откладывают до выхода из отпуска, что-то делают на свой страх и риск и потом переделывают.

А когда приходит заявление на увольнение, начинается настоящая паника. Срочные встречи, попытки записать всё что человек знает, договорённости о платных консультациях после ухода.

Катя при этом уже одной ногой на новой работе и передавать знания особо не рвётся — отвечает односложно, на встречи приходит без подготовки.

За две недели происходит больше документирования, чем за два предыдущих года: половина в чатах, которые через месяц никто не найдёт, половина в Confluence, куда никто не привык заходить.

Через месяц после ухода кто-то задаёт вопрос про тот самый платёжный модуль и упирается в код, который писал человек с полной докой в голове. Дока ушла вместе с ним.

У DORA в исследовании 2023 года есть цифра: команды с качественной документацией показывают на 25% выше team performance, чем команды с плохой документацией.

—

Главный аргумент против документации — «нет времени писать». Немного цифр: — команда из 10 человек по медиане рынка на май 2026 стоит компании 2,2 млн ₽ в месяц на руки — без качественной документации она выдаёт на 25% меньше результата, чем могла бы — в деньгах это около 440 тыс. ₽ недополученной ценности каждый месяц.

Двое из десяти человек в команде фактически работают вхолостую и оплачивают отсутствие документации.

—

А у вас как: пишете доку системно или живёте на тех, кто всё помнит?

#лебедева_ит #лебедева_процессы #лебедева_команды