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