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