Захтев за повлачење (ПР) је ГитХуб функција која вам омогућава да предложите измене у спремишту за које немате приступ за писање. Одржавачи спремишта могу прегледати ове промене и, ако желе, спојити их у оригинално спремиште.
Отварање захтева за повлачење на ГитХуб-у је кључно за допринос пројектима отвореног кода и сарадњу са другим програмерима. Научите како да креирате и отворите захтев за повлачење на ГитХуб-у у само неколико једноставних корака.
Корак 1: Форкинг Репозиторијум
Форкинг репозиторијум на платформа ГитХуб креира копију—иначе познату као „форк“— тог спремишта, под вашим налогом. Рачвање спремишта вам омогућава да правите промене у коду без утицаја на оригинално спремиште.
Да бисте раздвојили спремиште, идите на његову главну страницу и кликните на виљушка дугме у горњем десном углу:
Попуните име спремишта (форк) и опциони опис и кликните Направите виљушку:
Сада сте направили копију оригиналног спремишта. Ово ново спремиште има везу са оригиналним тако да се све промене које унесете у код могу лако упоредити и поново спојити у њега.
Корак 2: Уношење промена у код
Након што сте раздвојили спремиште, можда ћете морати да га клонирате на своју локалну машину, у зависности од количине и природе промена које желите да предложите. Ако правите веома једноставне промене које не морате да тестирате, то можете да урадите на мрежи користећи ГитХуб веб уређивач.
Да бисте клонирали спремиште на своју локалну машину користећи Гит, покрените ову терминалну команду:
гит клон
Заменити са УРЛ-ом вашег спремишта - ово можете пронаћи на ГитХуб-у. Ова команда ће клонирати спремиште на вашу локалну машину, где можете слободно експериментисати и уносити измене у код.
Требало би да промене буду мале и фокусиране, јер велики захтеви за повлачење могу бити изазовни за преглед и спајање. Покушајте да ваше промене буду специфичне за један проблем или функцију, како бисте олакшали одржаваоцима да их прегледају и прихвате.
Након што унесете жељене промене локално, урезујте их и гурните их на ГитХуб форк користећи Гит.
Корак 3: Отварање захтева за повлачење
Након што урезујете своје измене на ГитХуб, требало би да видите промпт који вас упозорава да је ваша грана број „урезивања“ испред спремишта из којег сте је издвојили, на пример:
Кликните Допринесите испустити. Кликом на ово дугме од вас ће бити затражено да отворите захтев за повлачење. Затим кликните на Отворите захтев за повлачење дугме:
Нека спремишта имају посебне смернице за допринос, које обично можете пронаћи у датотеци ЦОНТРИБУТИНГ.мд, а које морате да пратите. Обавезно прочитајте и следите ове смернице пре него што пошаљете захтев за повлачење.
Затим попуните потребна поља и кликните на Креирајте захтев за повлачење дугме:
Ваша порука обавезивања треба да буде јасна и концизна, да описује промене које сте направили и разлоге који стоје иза њих. Ово ће помоћи одржаваоцима да разумеју ваше промене и олакшати им преглед кода.
Када креирате свој потез, мораћете да сачекате да га одржаваоци пројекта прегледају и споје или затворе. Одржавачи могу имати предлоге или повратне информације о вашем захтеву за повлачење. Будите отворени за промене и вољни да извршите ревизије ако то од вас траже.
Важност захтева за повлачењем
Захтеви за повлачење олакшавају сарадњу између програмера омогућавајући им да предлажу промене, дају повратне информације и прегледају код. Ово помаже да се подстакне осећај заједнице и сарадње у оквиру пројекта, што доводи до већег доприноса и бржег развоја.
Штавише, захтеви за повлачење организују историју пројекта и верзионисање тако што омогућавају одржаваоцима да прате различите верзије кода и промене направљене у свакој верзији.
