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

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

Warning

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

Назначение и удаление ревьюеров

Info

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

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

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

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

  1. В профиле репозитория:

    1. Выберите вкладку Запросы.
    2. Нажмите кнопку Новый запрос.
  2. На форме создания запроса в блоке Ревьюеры нажмите на пиктограмму шестеренки и выберите ревьюеров среди соавторов, отметив их галочками.

Назначение ревьюеров существующего запроса

  1. В профиле репозитория > Запросы выберите требуемый запрос.

  2. На странице ранее созданного запроса в блоке Ревьюеры нажмите на пиктограмму шестеренки и выберите ревьюеров среди соавторов.

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

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

Info

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

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

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

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

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

    Info

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

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

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

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

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

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

    Info

    Также можно отменить одобрение запроса на слияние по нажатию на кнопку Отменить одобрение, если передумали.

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

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

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

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

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

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

Info

Вы можете скопировать ссылку на конкретную строку в файле. Для этого:

  1. Нажмите на нужную строку во вкладке Измененные файлы в запросе.
  2. Далее — на появившуюся кнопку Три точки.
  3. Нажмите на Копировать ссылку. Эта ссылка ведет непосредственно к выбранной строке и может быть использована в комментариях или обсуждениях.

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

Комментарий в обсуждениях

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

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

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

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

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

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

Удаление комментария

Info

Удалить чужие комментарии в репозитории могут:

  1. Владелец репозитория.
  2. Соавторы с правами администратора.
  3. Соавторы с правами на запись.
  4. Владельцы организации (команда Owners).
  5. Участники команды с правами администратора.
  6. Участники команды с правами на запись.
  1. Перейдите на страницу запроса.

  2. Выберите комметарий, который хотите удалить, и нажмите 3 точки.

  3. Нажмите на кнопку Удалить.

  4. Подтвердите удаление комментария.

  5. Комментарий должен исчезнуть.