Izvilkšanas pieprasījums (PR) ir GitHub līdzeklis, kas ļauj ierosināt izmaiņas repozitorijā, kurai jums nav rakstīšanas piekļuves. Repozitorija uzturētāji var pārskatīt šīs izmaiņas un, ja vēlas, apvienot tās sākotnējā repozitorijā.
Izvilkšanas pieprasījumu atvēršana vietnē GitHub ir ļoti svarīga, lai veicinātu atvērtā pirmkoda projektus un sadarbotos ar citiem izstrādātājiem. Uzziniet, kā izveidot un atvērt izvilkšanas pieprasījumu vietnē GitHub, veicot tikai dažas vienkāršas darbības.
1. darbība. Repozitorija sadalīšana
Forking a repozitorijs ieslēgts GitHub platforma jūsu kontā izveido šī krātuves kopiju (citādi sauktu par "dakšiņu"). Repozitorija atdalīšana ļauj veikt izmaiņas kodā, neietekmējot sākotnējo repozitoriju.
Lai izveidotu repozitoriju, pārejiet uz tās galveno lapu un noklikšķiniet uz dakša poga augšējā labajā stūrī:
Ievadiet repozitorija nosaukumu (dakša) un izvēles aprakstu un noklikšķiniet uz Izveidojiet dakšiņu:
Tagad esat izveidojis sākotnējās krātuves kopiju. Šai jaunajai krātuvei ir savienojums ar oriģinālo, lai visas izmaiņas, ko veicat kodā, varētu viegli salīdzināt un atkal apvienot tajā.
2. darbība: izmaiņu veikšana kodā
Kad repozitorijs ir izveidots, iespējams, tas ir jāklonē vietējā datorā atkarībā no ierosināto izmaiņu apjoma un veida. Ja veicat ļoti vienkāršas izmaiņas, kuras jums nav jāpārbauda, varat to izdarīt tiešsaistē, izmantojot GitHub tīmekļa redaktors.
Lai klonētu repozitoriju vietējai mašīnai, izmantojot Git, palaidiet šo termināļa komandu:
git klons
Aizvietot ar repozitorija URL — to varat atrast vietnē GitHub. Šī komanda klonēs repozitoriju uz jūsu vietējo mašīnu, kur varēsit brīvi eksperimentēt un veikt izmaiņas kodā.
Izmaiņas ir jāveic mazas un mērķtiecīgas, jo lielus piesaistes pieprasījumus var būt grūti pārskatīt un apvienot. Centieties, lai izmaiņas būtu saistītas ar vienu problēmu vai līdzekli, lai uzturētājiem būtu vieglāk tās pārskatīt un pieņemt.
Pēc vēlamo izmaiņu veikšanas lokāli veiciet tās un ievietojiet tās savā GitHub dakšā izmantojot Git.
3. darbība. Izvilkšanas pieprasījuma atvēršana
Pēc tam, kad esat veicis izmaiņas GitHub, jums vajadzētu redzēt uzvedni, kas brīdina, ka jūsu filiālei ir vairākas saistības, kas veiktas pirms repozitorija, no kuras to izveidojāt, piemēram:
Noklikšķiniet uz Piedalieties nomest lejā. Noklikšķinot uz šīs pogas, tiks parādīts aicinājums atvērt vilkšanas pieprasījumu. Pēc tam noklikšķiniet uz Atvērt izvilkšanas pieprasījumu poga:
Dažās krātuvēs ir jāievēro īpašas ieguldījumu vadlīnijas, kuras parasti varat atrast failā CONTRIBUTING.md. Pirms izvilkšanas pieprasījuma iesniegšanas noteikti izlasiet un ievērojiet šīs vadlīnijas.
Pēc tam aizpildiet nepieciešamos laukus un noklikšķiniet uz Izveidot izvilkšanas pieprasījumu poga:
Jūsu apņemšanās ziņojumam jābūt skaidram un kodolīgam, aprakstot veiktās izmaiņas un to pamatojumu. Tas palīdzēs uzturētājiem izprast jūsu izmaiņas un atvieglos koda pārskatīšanu.
Kad esat izveidojis savu izvilkumu, jums būs jāgaida, līdz projekta uzturētāji to pārskatīs un apvienos vai aizvērs. Uzturētājiem var būt ieteikumi vai atsauksmes par jūsu piesaistes pieprasījumu. Esiet atvērts izmaiņām un esiet gatavs veikt labojumus, ja viņi to lūdz.
Izvilkšanas pieprasījumu nozīme
Izvilkšanas pieprasījumi atvieglo sadarbību starp izstrādātājiem, ļaujot tiem ierosināt izmaiņas, sniegt atsauksmes un pārskatīt kodu. Tas palīdz veicināt kopienas sajūtu un sadarbību projektā, nodrošinot lielāku ieguldījumu un ātrāku attīstību.
Turklāt izvilkšanas pieprasījumi organizē projekta vēsturi un versiju izveidi, ļaujot uzturētājiem sekot līdzi dažādām koda versijām un katrā versijā veiktajām izmaiņām.
