Качество и актуальность внутренней технической документации — один из ключевых факторов, влияющих на скорость онбординга и автономность разработчиков. Устаревшая документация хуже, чем её отсутствие, потому что вводит в заблуждение. Метрика включает наличие архитектурных описаний, ранбуков, API-документации и их регулярное обновление.
Ясность и актуальность доков. Команды с хорошей документацией в 2.4 раза чаще становятся элитными.
УЛУЧШАЕТСЯ: Весь код доступен для поиска в одном месте, создавая «живую» документацию. Кросс-командная находимость решений значительно выше.
ЗНАЧИТЕЛЬНО УЛУЧШАЕТСЯ по необходимости: Распределенные команды обязаны инвестировать в тексты, так как не могут полагаться на «коридорные разговоры».
Передача знаний «осмосом» не работает при масштабе.
Хорошая документация: дни → часы.
Self-service ответы снижают прерывания.
Выгружает информацию из памяти в систему.
Автономность — возможность найти ответы самостоятельно.
Хорошая документация устраняет блокирующие вопросы. Self-service ответы = непрерванная работа над PR.
Хорошая документация обеспечивает самостоятельное получение контекста — разработчики не ждут, пока коллега проснётся.
Лучшая документация = лучшие AI-предложения.
Уходящие разработчики уносят с собой tribal knowledge.
Команды, инвестирующие в качество асинхронности, естественным образом производят лучшую документацию.