Сведения о просмотре запросов на вытягивание
Лучше всего просматривать изменения в запросе на вытягивание по одному файлу за раз:
- Проверьте каждый отдельный файл, измененный в запросе на вытягивание.
- Оставляйте комментарии к конкретным изменениям.
- После просмотра файла отметьте его как просмотренный , чтобы свернуть его и отслеживать свой прогресс.
- Индикатор выполнения в заголовке запроса на вытягивание показывает, сколько файлов вы просмотрели.
- Когда вы закончите, вы можете утвердить запрос на вытягивание или запросить изменения , отправив свой отзыв с кратким комментарием.
Понимание цели запроса pull
Получение четкого представления о мотивации запроса на вытягивание помогает вам получить обоснование для вашего обзора, чтобы вы могли сохранить его целенаправленным и значимым, а также предоставить отзыв, соответствующий замыслу автора запроса на вытягивание и целям проекта.
Существует несколько вариантов, позволяющих лучше понять контекст и обоснование предлагаемых изменений.
Использование боковой панели запроса на вытягивание для контекста
На боковой панели запроса на вытягивание вы можете найти ценный контекст, в том числе:
- Связанные проблемы или обсуждения: просмотрите их, чтобы понять проблемы или цели, на решение которых направлен запрос на вытягивание, или собрать информацию, например, о предыстории, проектных решениях или текущих дебатах.
- Связанные проекты или вехи: проверьте, как этот запрос pull вписывается в более крупные проекты или предстоящие выпуски.
Используйте эту информацию, чтобы составить свой обзор и проверить, соответствуют ли цели запроса на вытягивание первоначальному замыслу.
Начало проверки
-
В поле имени репозитория щелкните Запросы на вытягивание.
-
В списке запросов на вытягивание выберите запрос на вытягивание, который вы хотите просмотреть.
-
В запросе на вытягивание щелкните Files изменены.
Вы можете изменить формат дифференциального представления на этой вкладке, кликнув и выбрав единый или разделённый вид. Выбранное представление применится при просмотре различий для других запросов на вытягивание.
Вы также можете скрыть различия в пробелах. Выбранная настройка применяется только к данному запросу на вытягивание и будет сохранена при следующем посещении этой страницы.
-
При необходимости отфильтруйте файлы, чтобы отобразить только те файлы, которые нужно просмотреть или использовать дерево файлов для перехода к определенному файлу. Дополнительные сведения см. в разделе Фильтрация файлов в запросе на вытягивание.
-
Наведите указатель мыши на строку кода, к которой вы хотите добавить комментарий, и щелкните синий значок комментария.
-
При необходимости можно добавить комментарий по нескольким строкам. Чтобы выбрать диапазон линий, нажмите на номер строки первой строки, которую вы хотите прокомментировать, затем либо перетащите вниз до последней строки, либо, удерживая нажатой клавишу Shift , нажмите на номер последней строки. Затем вы можете нажать на синий значок комментария в последней строке, которую вы хотите прокомментировать. Кроме того, можно щелкнуть значок синего комментария рядом с первой строкой, которую вы хотите закомментировать, а затем перетащите вниз к последней строке, которую вы хотите закомментировать.
-
В поле комментария введите комментарий.
-
При необходимости, чтобы предложить определенное изменение строки или строки, щелкните , а затем измените текст в блоке предложений.
-
Чтобы закомментировать файл непосредственно справа от файла, щелкните и введите комментарий.
-
По завершении нажмите кнопку Начать проверку. Если вы уже начали проверку, можно нажать кнопку Добавить комментарий проверки.
До отправки отзыва ваши комментарии к строкам находятся в состоянии ожидания и видны только вам. Комментарии в состоянии ожидания можно изменять в любое время до отправки отзыва. Чтобы отменить ожидающий просмотр, включая все ожидающие комментарии, нажмите кнопку "Просмотреть изменения над измененным кодом", а затем нажмите кнопку "Отказаться от проверки".
Просмотр изменений в зависимостях
Если запрос на вытягивание содержит изменения зависимостей, вы можете выполнить проверку зависимостей в файле манифеста или блокировок, чтобы узнать, что изменилось, и проверить, не приводят ли изменения к уязвимостям системы безопасности. Дополнительные сведения см. в разделе Проверка изменений зависимостей в запросе на вытягивание.
-
В запросе на вытягивание щелкните Files изменены.
-
Справа в заголовке для манифеста или файла блокировки отобразите обзор зависимостей, нажав кнопку rich diff.
-
Кроме того, может потребоваться просмотреть отличия от источника, так как в файле манифеста или блокировок могут быть изменения, не затрагивающие зависимости, или зависимости, которые не могут быть проанализированы GitHub и поэтому не включаются в проверку зависимостей.
Чтобы вернуться к исходному представлению диффа, нажмите кнопку button.
Пометка файла как просмотренного
После завершения проверки файла можно пометить его как просмотренный, и он свернется. Если файл изменится после проверки, пометка просмотренного будет снята.
-
В запросе на вытягивание щелкните Files изменены.
-
Справа от заголовка файла, проверка которого завершена, щелкните Просмотрено.
Отправка отзыва
Завершив проверку всех нужных файлов в запросе на вытягивание, отправьте отзыв.
-
В запросе на вытягивание щелкните Files изменены.
-
Над измененным кодом нажмите кнопку Проверить изменения.
-
Введите комментарий, обобщающий ваши отзывы о предлагаемых изменениях.
-
Выберите тип отзыва, который нужно оставить:
- Выберите Комментарий, чтобы оставить общий отзыв, не утверждая изменения явным образом и не запрашивая дополнительные изменения.
- Выберите Утверждение, чтобы отправить отзыв и утвердить слияние изменений, предложенных в запросе на вытягивание.
- Выберите Запрос изменений, чтобы отправить отзыв, который необходимо обработать перед слиянием запроса на вытягивание.
-
Надмите Отправить отзыв.
Совет
- Параметр "Изменения запроса" является исключительно информационным и не будет препятствовать слиянию, если только набор правил или правило защиты классических ветвей настроено с параметром "требовать запрос на вытягивание". При настройке и совместном работе с
admin``ownerрепозиторием илиwriteдоступе к репозиторию отправляет запрос на проверку изменений, запрос на вытягивание не может быть объединен до тех пор, пока тот же сотрудник не отправит еще одну проверку утверждения изменений в запросе на вытягивание. - Владельцы и администраторы репозитория могут объединить запрос на вытягивание, даже если он не получил утверждение или если рецензент, запросивший изменения, покинул организацию либо недоступен.
- Если включены как обязательные проверки, так и отклонение устаревших проверок, то при отправке фиксации с изменением кода в ветвь утвержденного запроса на вытягивание утверждение отклоняется. Прежде чем запрос на вытягивание можно будет объединить, его необходимо будет проверить и утвердить еще раз.
- Если несколько открытых запросов на вытягивание имеют головную ветвь, указывающую на одну и ту же фиксацию, вы не сможете объединить их, если хотя бы для одного из них имеется ожидающая выполнения или отклоненная проверка.
- Если репозиторию требуются утверждения отзывов от пользователей с разрешениями на запись или администратор, рецензенты групп боковой панели утверждаются на уровне разрешений. Утверждения могут отображаться в двух разделах:
- В основном верхний раздел содержит утверждения от пользователей с разрешениями на запись или администратор, которые учитывают требования к слиянию. Утверждения от GitHub Copilot также отображаются в этом разделе, несмотря на то, что GitHub Copilot проверки не учитываются в соответствии с этими требованиями.
- В разделе сворачиванием (при наличии) отображаются утверждения от рецензентов, проверки которых не влияют на возможность объединения запроса на вытягивание.
- Авторы запросов на вытягивание не могут утвердить собственные запросы на вытягивание.