Фраза «у нас всё в коде» звучит круто — до тех пор, пока не случается одно из трёх: 1. Уходит сотрудник, который это писал. 2. Приходит аудит. 3. Новый человек тратит неделю, чтобы понять, почему система падает при вводе даты «31 февраля». Документация — не роскошь. Это базовая гигиена разработки и управления проектами. Вот почему миф о её ненужности стоит развеять раз и навсегда.

1. Код показывает как, но не почему Любой разработчик знает: прочитать код — не значит понять логику решения. Почему выбрали именно этот протокол? Почему отказались от аутентификации через OAuth? Почему статус «в работе» может быть у уже закрытой заявки? Без документации контекст теряется. А без контекста — каждое изменение становится лотереей. ** 2. «Завтра допишем» — фраза, после которой ничего не пишется** В реальности документация откладывается до тех пор, пока: - Заказчик не запросит сопроводительные материалы. - Коллега не спросит: «А где спецификация?» - Проект не уйдёт в поддержку — и начнётся ад из тикетов типа «а вы точно проверяли это в 2023?» Документировать в процессе — не медленнее. Это эффективнее. Особенно если использовать шаблоны, сниппеты и простые правила: каждая задача → краткое описание + схема + ограничения. —** 3. Документация = уважение к чужому времени** Представь: ты пришла в новый проект. Вместо хаотичного README с фразой «всё понятно» — видишь: - схему архитектуры, - описание ключевых решений с датами и ссылками на обсуждения, - список известных кейсов, где система ведёт себя неочевидно. Ты не теряешь день на разбор полётов. Ты сразу работаешь. Это не бюрократия — это профессионализм. —** 4. Хорошая документация — про защиту, а не про контроль** Она спасает: - от ошибок повторного внедрения, - от споров «а кто сказал, что так надо?», - от потери знаний при смене команды. Это не отчёт для начальства. Это живой артефакт проекта — как схема электропроводки в доме. Без неё можно жить… пока не понадобится что-то поменять.

Вывод Документация — не тормоз, а ускоритель. Она не для галочки, а для ясности. И тот, кто считает её лишней, либо ещё не сталкивался с последствиями её отсутствия, либо просто не отвечает за последствия. #документы #документыбезслез #документооборот #техническоеписательство