Как писать замечания к чужому коду
Проверка кода ссорит команды чаще споров о технологиях, и обычно из-за формы.
Разделяйте уровни: «сломается на пустом списке» — блокирующее, «можно короче» — вкусовое и помечается как необязательное. Один тон для всего превращает придирку к именам в обвинение.
Пишите про код, а не про человека.
Объясняйте причину: замечание без объяснения — приказ, с объяснением — обучение.
Больше десяти правок — не пишите, зовите на пятнадцать минут разговора.
Отмечайте хорошее: проверка, из которой приходят только претензии, вызывает глухое сопротивление.
И помните про темп: код, который висит на проверке три дня, устаревает, а автор всё это время не может двигаться дальше.
IT Ульяновск — t.me/it_ulyanovsk
IT Ульяновск
@it_ulyanovsk
Как писать замечания к чужому коду
Этот пост опубликован в Telegram-канале IT Ульяновск. Подписаться можно по ссылке: @it_ulyanovsk.