Ištraukimo užklausa (PR) yra „GitHub“ funkcija, leidžianti siūlyti saugyklos, prie kurios neturite rašymo prieigos, pakeitimus. Saugyklos prižiūrėtojai gali peržiūrėti šiuos pakeitimus ir, jei pasirenka, sujungti juos į pradinę saugyklą.
Ištraukimo užklausų atidarymas „GitHub“ yra labai svarbus prisidedant prie atvirojo kodo projektų ir bendradarbiaujant su kitais kūrėjais. Sužinokite, kaip sukurti ir atidaryti ištraukimo užklausą „GitHub“ atlikdami kelis paprastus veiksmus.
1 veiksmas: saugyklos išsišakojimas
Įjungti saugyklą GitHub platforma sukuria tos saugyklos kopiją (kitaip vadinamą šakute) jūsų paskyroje. Saugyklos šakotis leidžia keisti kodą nepažeidžiant pradinės saugyklos.
Norėdami iškelti saugyklą, eikite į pagrindinį jos puslapį ir spustelėkite šakutė mygtuką viršutiniame dešiniajame kampe:
Įveskite saugyklos pavadinimą (šakutę) ir pasirenkamą aprašymą ir spustelėkite Sukurkite šakutę:
Dabar sukūrėte originalios saugyklos kopiją. Ši nauja saugykla yra susijusi su originalia, todėl bet kokius kodo pakeitimus galima lengvai palyginti ir vėl sujungti į jį.
2 veiksmas: kodo keitimas
Sukūrus saugyklą, gali tekti ją klonuoti į vietinį kompiuterį, atsižvelgiant į norimų pasiūlyti pakeitimų kiekį ir pobūdį. Jei atliekate labai paprastus pakeitimus, kurių jums nereikia tikrinti, galite tai padaryti internetu naudodami GitHub žiniatinklio redaktorius.
Norėdami klonuoti saugyklą į vietinį kompiuterį naudodami Git, paleiskite šią terminalo komandą:
git klonas
Pakeiskite su savo saugyklos URL – tai galite rasti GitHub. Ši komanda klonuuos saugyklą į jūsų vietinį kompiuterį, kur galėsite laisvai eksperimentuoti ir keisti kodą.
Pakeitimai turėtų būti nedideli ir sutelkti, nes dideles ištraukimo užklausas gali būti sudėtinga peržiūrėti ir sujungti. Stenkitės, kad pakeitimai būtų susiję su viena problema ar funkcija, kad prižiūrėtojams būtų lengviau juos peržiūrėti ir priimti.
Atlikę norimus pakeitimus vietoje, patvirtinkite juos ir perkelkite juos į savo „GitHub“ šakę naudojant Git.
3 veiksmas: ištraukimo užklausos atidarymas
Atlikę pakeitimus „GitHub“, turėtumėte pamatyti raginimą, įspėjantį, kad jūsų filialas turi keletą „įsipareigojimų“ prieš saugyklą, iš kurios ją atsijungėte, pavyzdžiui:
Spustelėkite Prisidėti išskleidžiamąjį meniu. Spustelėję šį mygtuką būsite paraginti atidaryti ištraukimo užklausą. Tada spustelėkite Atidaryti ištraukimo užklausą mygtukas:
Kai kurios saugyklos turi konkrečias įnašo gaires, kurias paprastai galite rasti faile CONTRIBUTING.md, kurių turite laikytis. Prieš pateikdami ištraukimo užklausą, būtinai perskaitykite ir vadovaukitės šiomis gairėmis.
Tada užpildykite reikiamus laukus ir spustelėkite Sukurti ištraukimo užklausą mygtukas:
Jūsų įsipareigojimo pranešimas turi būti aiškus ir glaustas, jame turi būti aprašyti jūsų atlikti pakeitimai ir jų motyvai. Tai padės prižiūrėtojams suprasti jūsų pakeitimus ir lengviau peržiūrėti kodą.
Sukūrę trauką, turėsite palaukti, kol projekto prižiūrėtojai jį peržiūrės ir sujungs arba uždarys. Prižiūrėtojai gali turėti pasiūlymų ar atsiliepimų dėl jūsų užklausos. Būkite atviri pokyčiams ir pasiruošę pataisyti, jei jie jūsų paprašys.
Ištraukimo užklausų svarba
Ištraukimo užklausos palengvina kūrėjų bendradarbiavimą, nes jie gali siūlyti pakeitimus, teikti atsiliepimus ir peržiūrėti kodą. Tai padeda ugdyti bendruomeniškumo ir bendradarbiavimo projekte jausmą, todėl prisidedama prie daugiau ir greitesnio vystymosi.
Be to, ištraukimo užklausos tvarko projekto istoriją ir versijų kūrimą, leisdamos prižiūrėtojams sekti skirtingas kodo versijas ir kiekvienos versijos pakeitimus.
