«Опишем потом»: главная фраза, которая убивает IT-проекты (и сколько это стоит)
Почему документация — это страховка бизнеса, а не бюрократия
«Опишем потом». «Документацию — позже». «Сначала надо сделать, а запишем когда-нибудь». Знакомая фраза? Наверняка вы её слышали от своих разработчиков. Может быть, даже сами её говорили.
Эта фраза — убийца IT-проектов. И вот почему.
- На старте. Нужно быстро запуститься, показать MVP, занять место на рынке. Документация? Кому она нужна, у нас и так всё работает. Напишем потом, когда время будет.
- В процессе роста. Новые фичи приносят прибыль. Релизы каждый день. Конкуренты не спят. Документация? Потом. Сейчас важнее.
- При смене команды. Кто-то уходит. Знания уходят вместе с ним. Документации нет. «А где пароль от сервера?» — «Не знаю, у Васи было».
- Новая команда заходит. Ничего не понимает. Начинает разбираться методом тыка. Тратит недели. Документацию писать некогда — надо чинить то, что ломается, и делать фичи, которые обещали клиентам.
Через пару лет у вас проект, который приносит деньги, но никто не знает, как он работает. Каждый сбой — лотерея. Каждый новый сотрудник — недели простоя. Каждая смена подрядчика — месяц разбирательства.
Сколько это стоит. Скрытые расходы, о которых вы не думаете
Давайте посчитаем. Не в «абстрактных рисках», а в реальных деньгах.
Сценарий 1. Новый сотрудник
Без документации новый программист или подрядчик тратит 2–4 недели на то, чтобы просто понять, как всё устроено. С зарплатой 200 000 ₽ в месяц — это 100–200 тысяч рублей на разбирательство. Вы платите за то, чтобы человек «вник», а не за результат.
Сценарий 2. Смена подрядчика
Старый подрядчик ушёл (или вы решили его сменить). Новый начинает с нуля. Тратит месяц на разбор архитектуры. Счёт — от 500 000 ₽. За воздух. За то, что не сделано.
Сценарий 3. Инцидент
Сайт упал. Команда вместо «чинить» разбирается «как это вообще работает». Каждый час простоя — потерянные клиенты и деньги. Для среднего интернет-магазина час простоя может стоить 50 000–100 000 ₽. Сутки — 1–2 миллиона. Плюс потерянные клиенты, которые ушли к конкурентам и могут не вернуться.
Сценарий 4. Зависимость от сотрудника
Ключевой программист уходит. Вы не можете его быстро заменить. Приходится платить ему больше (иногда в два-три раза), искать супер-дорогого консультанта (по 5–10 тысяч рублей в час) или терпеть простой.
Сценарий 5. «Быстрые фичи» с долгим хвостом
Разработчик сделал фичу быстро, не задокументировал. Через полгода эта фича ломается. Никто не помнит, как она устроена. Чинить её в три раза дольше, чем делать с нуля. Вы платите трижды: за быструю фичу, за её поломку и за долгий ремонт.
Почему «потом» не наступает
Потому что всегда есть что-то более срочное. Новый релиз. Важный клиент. Горящая задача. Документация не горит. Она просто... не существует. А потом приходит инцидент. И выясняется, что «потом» уже не нужно. Нужно «сейчас». Но документации нет. Команда паникует. Клиенты звонят. Вы теряете деньги.
Не нужно писать идеальную документацию на сотни страниц. Начните с простого:
- Схема: как сервисы связаны
- Список паролей и доступов (храните в защищённом месте)
- Инструкция по запуску: что делать, если всё упало
- Назначьте ответственного. Кто-то должен следить, чтобы документация не устаревала. Лучше всего — технический руководитель или DevOps-инженер.
- Проверяйте документацию. Раз в месяц пытайтесь восстановить проект по документации с нуля. Если не получается — документация не работает.
Итог
Документация стоит денег. Но её отсутствие стоит в разы дороже. Инвестиция в документацию — это инвестиция в снижение рисков. Как страховка: платите немного сейчас, чтобы не платить много потом.
«Опишем потом» — это главная фраза, которая убивает IT-проекты. Замените её на «сделаем сейчас». Ваш будущий я скажет вам спасибо.