Skip to main content

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

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

Сведения о комментариях в запросах на вытягивание

Вы можете добавить комментарий на вкладке Беседа запроса на вытягивание, чтобы оставить общие комментарии, вопросы или реквизиты. Кроме того, вы можете предложить изменения, которые автор запроса на вытягивание может применить непосредственно из вашего комментария.

Вы также можете закомментировать определенные файлы или разделы файла на вкладке "Файлы по запросу на вытягивание ", измененной в виде отдельных строк или примечаний к файлам, или как часть проверка запроса на вытягивание. Добавление примечаний к строкам или файлам — отличный способ обсудить вопросы о реализации или предоставить отзыв автору. Дополнительные сведения о проверка запроса на вытягивание см. в разделе Сведения о проверках запроса на вытягивание.

Дополнительные сведения о добавлении строк или примечаний к файлу в проверка запроса на вытягивание см. в разделе Просмотр предлагаемых изменений в запросе на вытягивание.

Примечание.

Если вы отвечаете на запрос на вытягивание по электронной почте, комментарий будет добавлен на вкладке "Беседа" и не будет частью проверка запроса на вытягивание.

Чтобы ответить на существующую строку или комментарий к файлу, необходимо перейти к комментариям на вкладке "Беседа " или " Файлы" , а также добавить под ним дополнительный комментарий.

Совет

  • Комментарии с запросами поддерживают то же форматирование , что и обычные комментарии к GitHub, например @mentions, эмодзи и ссылки.
  • Вы можете добавить реакции на комментарии в запросах на вытягивание на вкладке Измененные файлы.

Добавление комментариев в запрос на вытягивание

  1. В поле имени репозитория щелкните Запросы на вытягивание.

    Снимок экрана: главная страница репозитория. На горизонтальной панели навигации вкладка с меткой "Запросы на вытягивание" выделена темно-оранжевым цветом.

  2. В списке запросов на вытягивание щелкните запрос на вытягивание, в котором вы хотите оставить строковые комментарии.

  3. В запросе на вытягивание щелкните Files изменены.

    Снимок экрана: вкладки для запроса на вытягивание. Вкладка "Измененные файлы" выделена темно-оранжевым цветом.

  4. Наведите указатель мыши на строку кода, к которой вы хотите добавить комментарий, и щелкните синий значок комментария.

    Снимок экрана: дифф в запросе на вытягивание. Рядом с номером строки выделен значок синего плюса с оранжевым контуром.

  5. При необходимости можно добавить комментарий по нескольким строкам. Чтобы выбрать диапазон линий, нажмите на номер строки первой строки, которую вы хотите прокомментировать, затем либо перетащите вниз до последней строки, либо, удерживая нажатой клавишу Shift , нажмите на номер последней строки. Затем вы можете нажать на синий значок комментария в последней строке, которую вы хотите прокомментировать. Кроме того, можно щелкнуть значок синего комментария рядом с первой строкой, которую вы хотите закомментировать, а затем перетащите вниз к последней строке, которую вы хотите закомментировать.

  6. В поле комментария введите комментарий.

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

    Снимок экрана: поле комментария для проверки. Значок диффа файла, предлагающий определенное изменение, описано в темно-оранжевый цвет.

  8. Чтобы закомментировать файл непосредственно справа от файла, щелкните и введите комментарий.

    Снимок экрана: файл изображения на странице "Измененные файлы" запроса на вытягивание. Справа от файла значок комментария выделен оранжевым цветом.

  9. Когда вы закончите, выполните следующие действия.

    • Если вы хотите добавить только один комментарий, нажмите кнопку "Добавить один комментарий".

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

      По завершении нажмите кнопку "Готово" в правом верхнем углу страницы, оставьте сводку по обзору и нажмите кнопку "Отправить отзыв".

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

Разрешение бесед

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

Чтобы указать, что беседа на вкладке Измененные файлы завершена, нажмите кнопку Разрешить беседу.

Вся беседа будет свернута и помечена как разрешенная, что упрощает поиск бесед, которые все еще требуют разрешения.

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

Обнаружение и навигация по беседам

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

В этом представлении можно увидеть, какие беседы являются неразрешенными, разрешенными и устаревшими. Это упрощает обнаружение и разрешение бесед.

Снимок экрана: меню "Беседы" на вкладке "Измененные файлы" запроса на вытягивание.

Дополнительные материалы