Перейти к основному содержимому

Проверка запроса на слияние

Запрос на слияние предоставляет возможность просмотра изменений в файлах в ветках в вашем хранилище. Эти изменения показаны как разница между текущим состоянием целевой ветки и предлагаемым к слиянию изменениями.

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

В запросе на слияние вы можете просматривать изменения в отдельных файлах.

Настройка интерфейса для просмотра изменений в файлах

Чтобы настроить интерфейс для просмотра изменений:

  1. Откройте запрос на слияние.
  2. Перейдите на вкладку File changes. В дереве файлов будут выводиться файлы с изменениями либо добавленные файлы.
  3. При необходимости просмотра изменений в отдельном коммите вы можете выбрать отдельные коммиты в запросе на слияние для просмотра изменений в раскрывающемся меню над деревом файлов.
  4. Вы можете отфильтровать дерево файлов при помощи поля Search Keywords.
  5. В раскрывающемся меню Settings настройте вид просмотра изменений.
  6. В правой части интерфейса рядом с индикатором прогресса ревью нажмите кнопку развернуть для удобства просмотра изменений.

Просмотр изменений

Чтобы просмотреть изменения в запросе на слияние:

  1. В запросе на слияние перейдите на вкладку File changes.
  2. В дереве файлов выберите интересующий вас файл.
  3. Для текстовых файлов с большими изменениями загрузите diff-файл нажав на кнопку Load diff в окне просмотра.
  4. Если в файле уже присутствуют комментарии или предложения кода вы можете их сворачивать либо разворачивать для удобства.

Комментарии к исходному коду

Чтобы оставить комментарий к определённой части кода:

  1. Наведите курсор на начало части кода к которой хотите оставить комментарий. На строке появится кнопка +.
  2. Если вы хотите оставить комментарий к одной строке, то нажмите на появившуюся кнопку +. Если хотите оставить комментарий к нескольким строкам, то нажмите появившуюся кнопку + и удерживая её протяните до конца блока кода, когда будет выделен нужный блок кода отпустите кнопку. Откроется поле для ввода текста.
  3. В открывшемся поле для введите свой комментарий (поддерживается синтаксис Markdown).
  4. Нажмите кнопку Comment.

Комментарий появится рядом с выбранной строкой кода, а также в запросе на слияние на вкладке Overview.

Предложение исправлений

Чтобы предложить исправление определённой части кода:

  1. Наведите курсор на начало части кода к которой хотите предложить исправление. На строке появится кнопка +.

  2. Если вы хотите предложить исправление одной строки, то нажмите на появившуюся кнопку +. Если хотите предложить исправление нескольких строк, то нажмите появившуюся кнопку + и удерживая её протяните до конца блока кода. Когда будет выделен нужный блок кода отпустите кнопку. Откроется поле для ввода текста.

  3. В панели управления над открывшимся полем ввода текста нажмите кнопку Code suggestion.
    В текстовом поле появится следующая конструкция:

        ``` suggestion
    выделенный блок кода
  4. Исправьте выделенный блок кода внутри конструкции с кавычками.

  5. Нажмите кнопку Comment.

Предложение исправления появится рядом с выбранным блоком кода, а также в запросе на слияние на вкладке Overview.
Предложение исправления можно будет применить непосредственно в запросе на слияние.

Отметка просмотренных файлов

Когда запрос на слияние содержит множество файлов вы можете отмечать просмотренные файлы, чтобы отличать их от других.
В правом верхнем углу просмотра контента установите чек-бокс Read чтобы отметить файл просмотренным. При этом индикатор прогресса ревью изменит своё состояние и покажет количество просмотренных и оставшихся к просмотру файлов.

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

Чтобы оставить отметку о проверке:

  1. В запросе на слияние в правом верхнем углу нажмите кнопку Review comments.

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

  3. Выберите как будет применён ваш комментарий:

    • оставить комментарий в запросе на слияние без отметки о согласовании или отклонении запроса;
    • разрешить слияние;
    • оставить комментарий с пометкой о необходимости доработки запроса на слияние.

Отметки о проверке выводятся в запросе на слияние на вкладке Overview. После успешного ревью запроса на слияния необходимым количеством ревьюеров станет доступна возможность слияния.