Заявката за изтегляне (PR) е функция на GitHub, която ви позволява да предлагате промени в хранилище, до което нямате достъп за запис. Поддържащите хранилище могат да прегледат тези промени и, ако решат, да ги обединят в оригиналното хранилище.
Отварянето на заявки за изтегляне в GitHub е от решаващо значение за приноса към проекти с отворен код и сътрудничеството с други разработчици. Научете как да създавате и отваряте заявка за изтегляне в GitHub само с няколко лесни стъпки.
Стъпка 1: Разклоняване на хранилището
Разклоняване на хранилище на платформата GitHub създава копие — иначе известно като „форк“ — на това хранилище под вашия акаунт. Разклоняването на хранилище ви позволява да правите промени в кода, без да засягате оригиналното хранилище.
За да разклоните хранилище, отворете главната му страница и щракнете върху вилица бутон в горния десен ъгъл:
Попълнете името на хранилището (форк) и незадължително описание и щракнете Създайте вилица:
Сега сте създали копие на оригиналното хранилище. Това ново хранилище има връзка с оригинала, така че всички промени, които правите в кода, могат лесно да бъдат сравнени и обединени обратно в него.
Стъпка 2: Извършване на промени в кода
След като сте разклонили хранилището, може да се наложи да го клонирате на вашата локална машина, в зависимост от количеството и естеството на промените, които искате да предложите. Ако правите много прости промени, които не е необходимо да тествате, можете да го направите онлайн, като използвате уеб базираният редактор на GitHub.
За да клонирате хранилище към вашата локална машина с помощта на Git, изпълнете тази терминална команда:
git клонинг
Сменете с URL адреса на вашето хранилище – можете да го намерите в GitHub. Тази команда ще клонира хранилището на вашата локална машина, където можете свободно да експериментирате и да правите промени в кода.
Трябва да запазите промените си малки и фокусирани, тъй като големите заявки за изтегляне могат да бъдат предизвикателство за преглед и сливане. Опитайте се да запазите промените си специфични за един проблем или функция, за да улесните поддържащите да ги прегледат и приемат.
След като направите желаните от вас промени локално, ангажирайте ги и ги избутайте във вашия GitHub fork използвайки Git.
Стъпка 3: Отваряне на заявка за изтегляне
След като сте извършили промените си в GitHub, трябва да видите подкана, която ви предупреждава, че вашият клон е определен брой „комити“ преди хранилището, от което сте го разклонили, например:
Щракнете върху Допринесете падащо меню. Щракването върху този бутон ще ви подкани да отворите заявка за изтегляне. След това щракнете върху Отворете заявка за изтегляне бутон:
Някои хранилища имат конкретни насоки за принос, които обикновено можете да намерите във файл CONTRIBUTING.md, които трябва да следвате. Не забравяйте да прочетете и следвате тези указания, преди да изпратите заявка за изтегляне.
След това попълнете задължителните полета и щракнете върху Създайте заявка за изтегляне бутон:
Вашето съобщение за ангажимент трябва да е ясно и кратко, като описва промените, които сте направили, и мотивите зад тях. Това ще помогне на поддържащите да разберат вашите промени и ще ги улесни при прегледа на кода.
След като създадете своето изтегляне, ще трябва да изчакате поддържащите проекта да го прегледат и обединят или затворят. Поддържащите може да имат предложения или обратна връзка относно вашата заявка за изтегляне. Бъдете отворени за промени и готови да правите ревизии, ако ви поискат.
Значението на заявките за изтегляне
Заявките за изтегляне улесняват сътрудничеството между разработчиците, като им позволяват да предлагат промени, да предоставят обратна връзка и да преглеждат кода. Това помага да се насърчи чувството за общност и сътрудничество в рамките на проект, което води до повече приноси и по-бързо развитие.
Освен това заявките за изтегляне организират историята и версиите на проекта, като позволяват на поддържащите да следят различните версии на кода и промените, направени във всяка версия.