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