🎉 Версия 22.0.0. Что новенького? →
Совместная работаСовместное ревью

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

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

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

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

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

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

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

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

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

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

    Пример:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Код ревьюРевью владельцем кода