Запрос на вытягивание (PR) — это функция GitHub, которая позволяет вам предлагать изменения в репозиторий, к которому у вас нет доступа для записи. Сопровождающие репозитория могут просмотреть эти изменения и, если захотят, объединить их с исходным репозиторием.
Открытие запросов на вытягивание на GitHub имеет решающее значение для участия в проектах с открытым исходным кодом и сотрудничества с другими разработчиками. Узнайте, как создать и открыть запрос на вытягивание на GitHub всего за несколько простых шагов.
Шаг 1: Разветвление репозитория
Разветвление репозитория на платформа GitHub создает копию — также известную как «форк» — этого репозитория под вашей учетной записью. Разветвление репозитория позволяет вам вносить изменения в код, не затрагивая исходный репозиторий.
Чтобы разветвить репозиторий, перейдите на его главную страницу и нажмите кнопку вилка кнопка в правом верхнем углу:
Заполните имя репозитория (форк) и необязательное описание и нажмите Создать форк:
Теперь вы создали копию исходного репозитория. Этот новый репозиторий имеет связь с исходным, поэтому любые изменения, которые вы вносите в код, можно легко сравнить и снова объединить с ним.
Шаг 2. Внесение изменений в код
После того, как вы разветвите репозиторий, вам может потребоваться клонировать его на локальный компьютер, в зависимости от количества и характера изменений, которые вы хотите предложить. Если вы вносите очень простые изменения, которые вам не нужно тестировать, вы можете сделать это онлайн, используя веб-редактор GitHub.
Чтобы клонировать репозиторий на локальный компьютер с помощью Git, выполните следующую команду терминала:
мерзавец клон
Заменять с URL-адресом вашего репозитория — вы можете найти это на GitHub. Эта команда клонирует репозиторий на ваш локальный компьютер, где вы можете свободно экспериментировать и вносить изменения в код.
Ваши изменения должны быть небольшими и целенаправленными, так как большие запросы на вытягивание могут быть сложными для просмотра и слияния. Старайтесь, чтобы ваши изменения были привязаны к одной проблеме или функции, чтобы сопровождающим было легче просмотреть и принять их.
После локального внесения желаемых изменений зафиксируйте их и отправьте в свою вилку GitHub. используя Git.
Шаг 3: Открытие запроса на слияние
После того, как вы зафиксировали свои изменения в GitHub, вы должны увидеть подсказку, предупреждающую вас о том, что ваша ветка на несколько «коммитов» опережает репозиторий, из которого вы ее разветвили, например:
Нажмите на Способствовать падать. При нажатии на эту кнопку вам будет предложено открыть запрос на включение. Затем нажмите кнопку Открытый пулреквест кнопка:
В некоторых репозиториях есть особые рекомендации по внесению вклада, которые обычно можно найти в файле CONTRIBUTING.md, которым необходимо следовать. Перед отправкой запроса на вытягивание обязательно прочитайте и следуйте этим рекомендациям.
Далее заполните необходимые поля и нажмите кнопку Создать запрос на включение кнопка:
Ваше сообщение о коммите должно быть четким и кратким, описывая внесенные вами изменения и их причины. Это поможет сопровождающим понять ваши изменения и облегчит им просмотр кода.
После того, как вы создали пулл, вам нужно дождаться, пока сопровождающие проекта просмотрят его и объединят или закроют. У сопровождающих могут быть предложения или отзывы по вашему запросу на вытягивание. Будьте открыты для изменений и готовы внести поправки, если вас об этом попросят.
Важность запросов на слияние
Запросы на вытягивание облегчают сотрудничество между разработчиками, позволяя им предлагать изменения, оставлять отзывы и проверять код. Это помогает укрепить чувство общности и сотрудничества в рамках проекта, что приводит к большему вкладу и ускорению разработки.
Кроме того, запросы на вытягивание организуют историю проекта и управление версиями, позволяя сопровождающим отслеживать различные версии кода и изменения, внесенные в каждую версию.