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

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

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

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

Создание запроса и назначение ревьюеров

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

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

  1. владелец репозитория;
  2. соавторы с правами на запись и выше.
  1. В профиле репозитория:

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

    Пример:

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

    Пример:

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

    Пример:

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

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

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

Коммиты запроса и изменения

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

Пример:

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

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

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

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

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

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

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

  1. Перейдите на страницу запроса.

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

    Пример:

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

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

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

    Пример:

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

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

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

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

    Пример:

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

    Пример:

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

    Пример:

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

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

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

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

  1. Пример:

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

    Пример:

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

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

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

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

    Пример:

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

    Пример:

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