Tõmbepäring (PR) on GitHubi funktsioon, mis võimaldab teil teha ettepanekuid muudatuste tegemiseks hoidlas, millele teil pole kirjutamisõigust. Hoidla hooldajad saavad need muudatused üle vaadata ja soovi korral liita need algsesse hoidlasse.
Tõmbetaotluste avamine GitHubis on avatud lähtekoodiga projektidesse panustamisel ja teiste arendajatega koostöö tegemisel ülioluline. Siit saate teada, kuidas luua ja avada tõmbetaotlus GitHubis vaid mõne lihtsa sammuga.
1. samm: hoidla hargnemine
Hoidla moodustamine GitHubi platvorm loob teie konto alla selle hoidla koopia (muidu tuntud kui "kahvliga"). Hoidla hargnemine võimaldab teha koodis muudatusi, ilma et see mõjutaks algset hoidlat.
Hoidla harutamiseks liikuge selle avalehele ja klõpsake nuppu kahvel nupp paremas ülanurgas:
Sisestage hoidla nimi (kahvel) ja valikuline kirjeldus ning klõpsake Loo kahvel:
Nüüd olete loonud algse hoidla koopia. Sellel uuel hoidlal on seos originaaliga, nii et kõiki koodis tehtud muudatusi saab hõlpsasti võrrelda ja sellesse tagasi liita.
2. samm: koodis muudatuste tegemine
Pärast hoidla ühendamist peate võib-olla selle kohalikku masinasse kloonima, olenevalt pakutavate muudatuste hulgast ja olemusest. Kui teete väga lihtsaid muudatusi, mida te ei pea testima, saate seda teha veebis GitHubi veebipõhine redaktor.
Hoidla kloonimiseks kohalikku masinasse Giti abil käivitage see terminalikäsk:
git kloon
Asenda koos oma hoidla URL-iga – leiate selle GitHubist. See käsk kloonib hoidla teie kohalikku masinasse, kus saate vabalt katsetada ja koodis muudatusi teha.
Peaksite oma muudatused olema väikesed ja keskendunud, kuna suurte tõmbamistaotluste ülevaatamine ja ühendamine võib olla keeruline. Püüdke hoida oma muudatused konkreetse probleemi või funktsiooni kohta, et hooldajatel oleks lihtsam neid üle vaadata ja aktsepteerida.
Pärast soovitud muudatuste tegemist kohapeal kinnitage need ja lükake need oma GitHubi kahvlisse kasutades Git.
3. samm: tõmbamistaotluse avamine
Kui olete oma muudatused GitHubis sisse viinud, peaksite nägema viipa, mis hoiatab teid, et teie haru sooritab mitu „kohustust“ enne hoidlast, kust selle hargite, näiteks:
Klõpsake nuppu Panustada rippmenüüst. Sellel nupul klõpsamine palub teil avada tõmbetaotlus. Seejärel klõpsake nuppu Ava tõmbetaotlus nupp:
Mõnel hoidlal on konkreetsed kaastööjuhised, mille leiate tavaliselt failist CONTRIBUTING.md ja mida peate järgima. Enne tõmbamistaotluse esitamist lugege need juhised kindlasti läbi ja järgige neid.
Järgmisena täitke nõutud väljad ja klõpsake nuppu Loo tõmbamistaotlus nupp:
Teie kohustuste sõnum peaks olema selge ja lühike, kirjeldades tehtud muudatusi ja nende põhjendusi. See aitab hooldajatel teie muudatusi mõista ja hõlbustab koodi ülevaatamist.
Kui olete oma tõmbe loonud, peate ootama, kuni projekti hooldajad selle üle vaatavad ja ühendavad või sulgevad. Hooldajatel võib olla teie tõmbamistaotluse kohta ettepanekuid või tagasisidet. Olge muudatustele avatud ja valmis neid muutma, kui nad seda paluvad.
Tõmbetaotluste tähtsus
Tõmbetaotlused hõlbustavad arendajate vahelist koostööd, võimaldades neil teha muudatusi, anda tagasisidet ja vaadata koodi üle. See aitab edendada kogukonna- ja koostöötunnet projekti raames, mis toob kaasa suurema panuse ja kiirema arengu.
Lisaks korraldavad tõmbamispäringud projekti ajalugu ja versioonide loomist, võimaldades hooldajatel jälgida koodi erinevaid versioone ja igas versioonis tehtud muudatusi.
