Код-ревью Pull Request на GitHub

Станьте ревьюером: проверьте код по требованиям во вкладке Files changed, оставьте вежливые комментарии к строкам, запросите исправления и одобрите PR после нового коммита автора.

О продукте

Кадри, ментор

Привет! В прошлый раз ревью проходил твой Pull Request. Сегодня поменяемся ролями: ревьюером будешь ты. Марко из команды разработки открыл PR со скидкой на заказ — его нужно проверить. Но сначала — четыре простых правила для комментариев.

Справка по теме

Files changed

Вкладка PR, где видно, какие файлы и строки изменились: зелёные строки со знаком + добавлены, красные со знаком − удалены. Ревью начинают с неё.

Что проверять

Соответствие требованиям задачи (особенно граничные значения), понятность и читаемость: имена, отсутствие отладочного вывода и лишнего кода.

Комментарий к строке

Наведите курсор на строку — появится синий «+». Нажмите его, напишите комментарий и нажмите Add single comment. Так можно прокомментировать любое количество строк.

Review changes

Итог ревью: общий комментарий и решение. Comment — отзыв без одобрения и блокировки, Approve — можно сливать, Request changes — нужно исправить до слияния. Отправляется кнопкой Submit review.

Тон комментариев

Комментарий — про код, а не про автора. Укажите, что не так, объясните почему и предложите исправление. Вежливость и конкретность экономят время обоим.

После Request changes

Автор исправляет код отдельным коммитом в ту же ветку и делает push — PR обновляется сам. Ревьюер проверяет изменения ещё раз и ставит Approve, после чего PR можно слить (Merge).