Создание запроса на вытягивание в GitHub
После обновления или добавления содержимого пришло время создать запрос на вытягивание (PR). Этот шаг необходим для публикации изменений. Дополнительные сведения о PR см . в основах Git и GitHub.
Необходимые компоненты
- Определите репозиторий GitHub, в который хранится документация, которую вы хотите изменить.
- Создайте учетную запись GitHub, если у вас нет учетной записи.
- Установите средства Git и Markdown.
- Настройте локальный репозиторий Git.
- Внесение изменений в локальное клонирование
- Просмотрите основы Git и GitHub (необязательно).
Открытие запроса на вытягивание
В браузере перейдите к GitHub.
В правом верхнем углу выберите профиль и выберите репозитории.
Найдите репозиторий, в котором вы только что внесли изменения. Если существует несколько, выберите репозиторий для репозитория MicrosoftDocs вышестоящий (например, MicrosoftDocs/azure-docs).
Выберите вкладку "Запросы на вытягивание" в верхней части страницы.
Если вы видите зеленую кнопку "Сравнить" и "Запрос на вытягивание", нажмите эту кнопку.
Если кнопка не отображается, откройте новый PR вручную:
- Нажмите зеленую кнопку "Создать запрос на вытягивание".
- На странице "Сравнение изменений" убедитесь, что головной репозиторий : в раскрывающемся списке задано значение вилки (например, your-github-id/azure-docs).
- Измените сравнение: раскрывающийся список на рабочую ветвь.
- Просмотрите отображаемые изменения. Если изменения не отображаются, убедитесь, что вы сравниваете правильные ветви.
На странице "Открыть запрос на вытягивание" убедитесь, что:
- Базовый репозиторий: соответствует репозиторию вышестоящий (например, MicrosoftDocs/azure-docs).
- База: ветвь имеет значение ветвь по умолчанию (скорее всего, именованный main) в репозитории вышестоящий. Все изменения будут объединены с вышестоящая ветвь.
- Количество фиксаций и файлов, измененных, является ожидаемым.
Ваше первое сообщение о фиксации в ветви становится заголовком PR по умолчанию. Если вы хотите, измените заголовок, чтобы сделать его более подходящим для pr (например, обновление списка необходимых компонентов).
Добавьте необязательное описание. Описание помогает рецензентам понять цель вашего PR. Например, можно описать проблему, которую вы пытаетесь решить или причину, по которой вы вносите изменения.
Выберите "Создать запрос на вытягивание". Новый PR связан с рабочей ветвью в вилке. Пока pr не будет объединен, все новые фиксации, которые вы отправляете в ту же рабочую ветвь в вилке, автоматически включаются в PR.
Следующие шаги
Вы создали ваш PR, но вы еще не отправили его. Теперь вы готовы обработать запрос на вытягивание, чтобы убедиться, что он будет проверен и объединен в ветвь по умолчанию.