Плохо, когда люди на проекте занимаются документацией в основном лишь перед уходом, выполняя таски с предательским названием типа knowledge sharing.

Ещё хуже, когда про документацию вспоминают, когда с проекта ключевые люди уже ушли.

Документация — дорогой для команды и проекта процесс. В хороших проектах 10-20% может постоянно уходить на документирование. Это осознанные затраты, в реальности окупающиеся, особенно в постковидном мире с асинхронными коммуникациями.

Если не инвестировать в (постоянное) документирование, то эффективность работы команды снижается, онбоардинг растягивается, а взаимодействующие команды в результате компенсируют это умножающимися созвонами. Что раздражает каждую из сторон — и тех, кому нужно объяснять, и тем, кому нужно понимать, как это работает, чтобы пилить фичи или исправлять баги.

Документация — это не результат, документация — это процесс.

#pm