Даниил!
Прежде всего: если человек не хочет, чтобы его понимали, вы его не поймёте. Перевоспитание таких людей, вроде просьб вести аккуратную и понятную документацию, — неэффективное и неблагодарное занятие. А иногда это вообще настроит людей против вас.
В подобных ситуациях я знаю три варианта действий.
Работайте с заинтересованными людьми
Идеальный вариант — найти разработчиков, которые умеют и будут разговаривать с командой и бизнесом на доступном языке. Таких мало и платить им придётся больше. Но часто один заинтересованный специалист может заменить целую команду незаинтересованных.
Если вы не влияете на состав команды, попробуйте «продать» эту идею тем, кто влияет. Если из‑за проблем с коммуникацией бизнес теряет деньги — объясните это и предложите решение.
Лайфхак. Чтобы найти заинтересованных людей, сформулируйте принципы и отношение к работе, которого ждёте от кандидатов. Транслируйте и популяризируйте эти принципы, «поставьте вселенную в известность». Рано или поздно заинтересованные люди придут. Ещё можно выращивать людей с нужным отношением к работе внутри компании, организовав кузницу кадров. В бюро эти задачи решают кодекс бюрошника и школа.
Начните разбираться в предметной области
Становиться гуру разработки не нужно, даже краткий учебный курс по стеку ваших бэкендеров уже заметно повысит эффективность общения с ними. Приятный бонус — рост вашего авторитета в команде.
Это сложный и не быстрый вариант, но очень крутой в перспективе. Даже если вам придётся работать с самым неприятным разработчиком в мире, ваш опыт поможет получить более предсказуемый и качественный результат. Ну или как минимум не даст вас обмануть.
Забейте, если игра не стоит свеч
Иногда решение проблемы потребует столько усилий сейчас и в будущем, что это затмит всю пользу. Прежде чем что‑то предпринимать — посчитайте затраты и профит. Если ради красоты в задачах придётся развязать гражданскую войну в команде — может, и ну его нафиг. Мир не идеален и иногда необязательно быть лучшим ковбоем, достаточно быть живым ковбоем.
Это универсальные советы по работе с любыми специалистами, «разработчика» можно заменить на «дизайнера» или «автомеханика», всё останется актуальным.
Приглашаю уважаемых советчиков и бюрошников поделиться в коментах своими советами по теме.
P. S. Это был совет о веб‑разработке. Хотите знать всё о коде, тестах, фронтенд‑разработке, цеэсэсе, яваскрипте, рельсах и джейде? Присылайте вопросы.