Я не думаю, что полезно размышлять о мотивах людей, которые не принимают то, что вы считаете хорошей практикой, или которые продолжают делать то, что вы считаете плохой практикой. В этом бизнесе люди, попадающие в одну или обе эти категории, будут намного превосходить по численности те, с которыми вы будете встречаться лицом к лицу, поэтому перестаньте сводить с ума.
Вместо этого сосредоточьтесь на проблеме и возможных решениях.
1. Пишите хорошую документацию самостоятельно
Возможно, нереально ожидать, что все в вашей команде направят свои усилия на то, что вы считаете проблемой. Это особенно верно, если вы относительный новичок в команде. Рискну предположить, что это так, потому что если бы вы были одним из основателей команды, вполне вероятно, что вы уже решили эту проблему на раннем этапе.
Вместо этого подумайте над тем, чтобы самим написать хорошую документацию и заставить ее пользоваться. Например, если кто-то из моей команды спрашивает меня, где находится исходный код для проекта A или какая специальная конфигурация требуется для проекта A, я указываю их на вики-страницу Project A.
Если кто-то спросит меня, как написать новую реализацию Factory F, чтобы настроить что-то для Клиента C, я отвечу, что это на странице 10 руководства разработчика.
Большинство разработчиков ненавидят задавать вопросы, которые могут заставить их выглядеть так, как будто они не могут просто «прочитать код» даже больше, чем они ненавидят чтение документации, поэтому после достаточного количества ответов такого рода они сначала пойдут в документы.
2. Докажите ценность вашей документации
Убедитесь, что вы пользуетесь любой возможностью, чтобы указать, где документация доказывает свою ценность (или имела бы, если бы использовалась). Постарайтесь быть осторожными и избегайте «я же вам говорил», но совершенно справедливо говорить такие вещи, как
Для дальнейшего использования на вики-странице этого проекта есть информация о ветви основного кода, которая была создана для постоянной поддержки выпуска 2.1, поэтому в будущем мы можем избежать проведения полного регрессионного теста, если люди, которые поддерживают выпущенные версии, проверят вики перед проверкой кода.
или же
Я так рад, что записал шаги для выполнения Задачи T. Мне действительно все равно, если никто больше не использует его - это уже сэкономило мне больше времени, чем я потратил на его написание.
3. Получить управление на борту
После нескольких инцидентов, когда наличие документации значительно экономит время и деньги, вы, вероятно, заметите явную «оттепель» в отношении документации. Настало время нажать на точку, начав включать в ваши оценки время документирования (хотя, честно говоря, я обычно обновляю / создаю документы, пока выполняются длинные процессы, такие как компиляции или проверки). Особенно, если это недавний найм, возможно, это не будет подвергаться сомнению, но вместо этого рассматривается как новая практика, которую вы привносите с предыдущего рабочего места (что вполне может быть).
Слово предостережения: большинству боссов не нравится заставлять людей делать что-либо, особенно вещи, не связанные напрямую с оплачиваемой задачей, поэтому не ожидайте, что эта поддержка будет в форме мандата. Вместо этого, скорее всего, у вас будет относительно свободная возможность написать больше документов.
4. Поощряйте документацию, когда вы ее видите
Возможно, одна из причин, по которой люди не пишут документы так часто, как следовало бы, заключается в том, что они чувствуют, что никто не читает их. Поэтому, когда вы видите что-то, что вам нравится, обязательно упомяните, что вы были рады, что это было доступно.
Если ваша команда делает обзоры кода, это время, когда вы можете добавить несколько слов, чтобы получить хорошие комментарии.
Спасибо за документирование обходного пути для ошибки B в Framework G. Я не знал об этом, и я не думаю, что мог бы понять, что вы делали без этого там.
Если в вашей команде есть кто-то, кто действительно увлечен документацией, это не помешает развить этого человека за счет того, что он пойдет на обед или кофе и обязательно предложит небольшую проверку, чтобы противостоять разочарованию, которое они могут получить от встречи с остальной частью команды. не так сильно ценит документацию
Кроме того, это действительно не ваша проблема, если вы не занимаетесь лидирующей или управленческой должностью. Вы можете привести лошадь к воде, но вы не можете заставить ее пить. Если это не ваша лошадь, вы не можете быть счастливы, что она хочет пить, но все, что вы можете сделать, это заполнить кормушку.