IT Саратов
IT Саратов
@itnews_saratov

Как давать замечания к чужому коду

Ревью — место, где технический разговор чаще всего превращается в конфликт. Обычно из-за формы, а не из-за содержания.

Что помогает. Разделять обязательное и вкусовое: «здесь потеряется ошибка» и «я бы назвал иначе» — замечания разного веса, и когда они идут вперемешку, автор перестаёт понимать, что важно. Помечайте прямо: это блокирует, это предложение.

Объяснять причину, а не только вердикт. «Так не делают» не учит ничему, «при пустом списке здесь упадёт» — учит.

Спрашивать, когда не понимаете, а не предполагать худшее. Часто у странного решения есть причина, о которой вы не знаете.

Не выкладывать тридцать замечаний за раз. После десятого человек перестаёт воспринимать и начинает защищаться. Если правок правда много, лучше пятнадцать минут голосом.

И помнить о цели. Задача ревью — чтобы код стал лучше и чтобы автор в следующий раз сделал так сам. Не продемонстрировать, что вы бы сделали иначе.

В маленькой команде, где вы работаете с этими людьми годами, тон обходится дороже содержания.

IT Саратов — t.me/itsaratov_news
Этот пост опубликован в Telegram-канале IT Саратов (@itnews_saratov). Все его публикации — на странице канала.
Открыть в Telegram

Свежее в разделе «Сервисы и инфраструктура»

Все каналы раздела →

реклама в сети

Готовы запустить рекламу через сеть public.tg?

Новый оффер, продукт, GEO, кейс, событие или партнёрский запуск — соберём маршрут под задачу и отдадим медиаплан.

Telegram для медиаплана: @AFFtop_connect. Быстрый тест: $20 за канал, $1000 за пакет по сети.