Совместное ревью

Совместное ревью

Проведение совместного ревью предполагает перекрестную проверку измененного кода ревьюерами. Комментарии можно оставлять для отдельных строк кода или для всего пулл реквеста в целом. После получения нужного количества одобрений разблокируется кнопка коммита на слияние, чтобы пулл реквест можно было слить (смержить) с основной веткой.

⚠️
  1. Создатель запроса для защищенной ветки с заданным минимальным числом ревьюеров не сможет самостоятельно выполнить слияние, т.к. создатель не может быть ревьюером.
  2. Если в защищенной ветке выставлено ограничение на расширение файлов и такие файлы меняются в коммитах, то слияние будет заблокировано.
  3. Для ранее созданных запросов обновление правил защиты происходит спустя некоторое время.

Создание пулл реквеста и назначение ревьюеров

Добавлять ревьюеров можно только из списка соавторов (см. Добавление/удаление соавторов в репозиторий).

Добавлять ревьюеров могут:

  1. владелец репозитория;
  2. соавторы с правами на запись и выше.
  1. Перейдите во вкладку Запросы:

    пользователь выбирает вкладку запросов
  2. Нажмите кнопку Новый запрос

    пользователь нажимает кнопку нового запроса
  3. Определите ветки для слияния и нажать кнопку Создать запрос:

    пользователь определяет ветки для слияния и нажимает кнопку создания запроса
  4. Выберите ревьюеров среди соавторов репозитория, отметив их галочками:

    пользователь выбирает ревьюеров
  5. На скриншоте выбранные ревьюеры отмечены галочками и их пиктограммы добавлены в блоке "ревьюеры":

    ревьюеры выбраны

Коммиты пулл реквеста и изменения

Откройте вкладку Коммиты на странице пулл реквеста и выберите коммит.

Пример:

коммиты запроса

Отобразятся изменения по коммиту:

Отобразятся изменения по коммиту

Удаление ревьюеров

Удалять ревьюеров могут:

  1. автор пулл реквеста (с правами на запись и выше);
  2. соавторы с правами администратора;
  3. владелец репозитория.

Для удаления себя из списка ревьюеров достаточно прав на запись.

  1. Перейдите на страницу пулл реквеста.

  2. Снимите галочки с ревьюеров:

    ревьюеры выбраны

    Соавтор-владелец пулл-реквеста может отменить ревью для другого соавтора.

  3. В блоке "ревьюеры" должны исчезнуть пиктограммы удаленных ревьюеров:

    пользователь выбирает ревьюеров

Проведение ревью

Сокращенное ревью

  1. Создайте пулл реквест и на его странице добавьте ревьюера.

    Пример:

  2. Далее назначенный ревьюером пользователь на странице пулл реквеста нажимает Провести ревью, Утвердить и Опубликовать ревью.

    Пример:

  3. На странице пулл реквеста после получения необходимого количества одобрений нажмите Создать коммит на слияние.

    Пример:

Стандартное ревью

Подробный пример создания, одобрения и слияния пулл реквеста для защищенной ветки с заданным количеством ревьюеров представлен в разеделе Слияние пулл реквеста.

Добавление комментария

  1. Перейдите на страницу запроса (например, по ссылке из сообщения о запросе на слияния):

    ревьюер переходит на страницу запроса
  2. Оставьте комментарий и нажмите кнопку Добавить:

    ревьюер оставляет комментарий:

Где отображаются комментарии

Комментарии ревьюеров находятся на странице запроса на слияние во вкладке Обсуждение.

  1. Перейдите на страницу пулл реквеста (например по ссылке со страницы дашборда):

    ссылка для перехода к комментарию к запросу
  2. После нажатия на ссылку отобразится комментарий:

    пользователь перешел к комментарию к запросу