Сообщество / Новая тема

Обсуждение статьиПервый комментарий откроет обсуждение — дальше все вопросы по этой статье будут собираться здесь

Об статье:
Почему документацию по серверу никто не читает и как это исправить

Где-то в репозитории или в корпоративной вики лежит файл вроде docs/infrastructure.md — кто-то потратил на него вечер год-полтора назад, когда настраивал сервер с нуля. В момент, когда этот сервер падает в три часа ночи, файл никто не открывает: либо про него забыли, либо не верят, что там написана правда, либо два экрана текста — непозволительная роскошь в ситуации, где решение нужно принять за минуту. Формально документация есть. Практически компания снова работает по памяти одного человека и по переписке в рабочем чате, где кто-то уже отвечал на этот…

Подробнее →