Kaip pateikti pirmąją užklausą „GitHub“

Kas yra šakės?

Kai mes mėgstame kažkieno saugyklą ir norėtume ją turėti savo „GitHub“ paskyroje, mes ją išsišakojame, kad galėtume su ja dirbti atskirai.

Kai mes šakojame saugyklą, gauname visos tos saugyklos egzempliorių su visa istorija. Po šakės mes galime padaryti viską, ką norime daryti, nepaveikdami originalios versijos.

Kas yra traukimo užklausa?

„Pull“ užklausos yra būdas, kuriuo mes prisidedame prie grupės ar atvirojo kodo projektų.

Pvz., Vartotojas Harry išsijungia „ThanoshanMV“ saugyklą ir atlieka tos saugyklos pakeitimus. Dabar Haris gali pateikti „ThanoshanMV“ užklausą, tačiau ThanoshanMV turi ją priimti ar atmesti. Tai tarsi sakymas: „ThanoshanMV, ar galėtum pritraukti mano pakeitimus?“

Ką reiškia prisidėti

Mes galime ne tik prisidėti prie atvirojo kodo projekto naudodami kodą, bet ir daugeliu kitų būdų. Kai kurie iš šių būdų aprašyti toliau.

Kaip sakoma „99xtechnology“ IT įmonės įsilaužimo pradžios vadove, prie atvirojo kodo projekto galime prisidėti šiais būdais:

  1. Dizainas: galite sukonstruoti projekto maketus, kad pagerintumėte jo naudojimą, pagerintumėte projekto naršymą ir meniu, remdamiesi vartotojų tyrimų programomis, kurkite logotipų ar marškinėlių meną ir pateikite projekto stiliaus vadovus.
  2. Rašymas: galite parašyti ir patobulinti projekto dokumentaciją arba išversti dokumentaciją, pradėti projekto naujienlaiškį arba rašyti projekto pamokas ir sutvarkyti svarbiausius dalykus iš adresų sąrašo arba kuruoti pavyzdžių aplanką, parodantį, kaip naudojami projektai.
  3. Tvarkymas: galite susieti pasikartojančias problemas, siūlyti naujų leidimų etiketes, pasiūlyti uždaryti senus neišspręstus klausimus ir užduoti klausimus apie neseniai atidarytas problemas, kad diskusija vyktų į priekį.
  4. Padėkite kitiems: atsakykite į klausimus atvirais klausimais, peržiūrėkite kitų žmonių pateiktų dokumentų kodą ir pasiūlykite patarėją kitam bendradarbiui.
  5. Kodavimas: padėkite išspręsti visas iškilusias problemas, paklauskite, ar galite suteikti naujų funkcijų, patobulinti įrankius ir testavimą.

Pateikime savo pirmąjį traukimo prašymą!

Jei nesate gerai susipažinę su „Git & GitHub“, peržiūrėkite „Git & GitHub“ pradedančiųjų vadovą.

1. Šakė saugyklą

Šakinis saugyklą spustelėdamas šakės mygtuką puslapio viršuje. Tai sukurs visos tos saugyklos egzempliorių jūsų paskyroje.

2. Klonuokite saugyklą

Kai saugykla bus jūsų paskyroje, klonuokite ją į savo kompiuterį, kad galėtumėte su ja dirbti vietoje.

Norėdami klonuoti, spustelėkite klonavimo mygtuką ir nukopijuokite nuorodą.

Atidarykite terminalą ir vykdykite šią komandą. Tai klonuos kapinyną vietoje.

$ git clone [HTTPS ADDRESS]

Dabar mes sukūrėme pagrindinio filialo kopiją iš pagrindinės internetinės projekto saugyklos.

Turime pereiti į tą klonuotą katalogą vykdydami šią komandą:

$ cd [NAME OF REPOSITORY]

3. Sukurkite filialą

Gera praktika yra sukurti naują filialą dirbant su saugyklomis, nesvarbu, ar tai nedidelis projektas, ar prisidedant prie grupės darbo.

Filialo pavadinimas turėtų būti trumpas ir atspindėti mūsų atliekamą darbą.

Dabar sukurkite filialą naudodami git checkoutkomandą:

$ git checkout -b [Branch Name]

4. Atlikite pakeitimus ir įsipareigokite jiems

Atlikite esminius projekto pakeitimus ir išsaugokite.

Tada vykdykite git statusir pamatysite pakeitimus.

Pridėkite tuos pakeitimus prie šakos, kurią ką tik sukūrėte naudodami git addkomandą:

$ git add .

Dabar git commitatlikite šiuos pakeitimus naudodami komandą:

$ git commit -m "Adding an article to week 02 of articles of the week"

5. Paspauskite pakeitimus į „GitHub“

Norėdami pakeisti „GitHub“ pakeitimus, turime nustatyti nuotolinio valdymo pulto pavadinimą.

$ git remote

Šios saugyklos nuotolinio valdymo pulto pavadinimas yra „kilmė“.

Nustačius nuotolinio valdymo pulto pavadinimą, galime saugiai perkelti tuos pakeitimus į „GitHub“.

git push origin [Branch Name]

6. Sukurkite užklausą

Eikite į savo saugyklą „GitHub“ ir pamatysite mygtuką „Palyginti ir traukti užklausą“ ir spustelėkite jį.

Pateikite reikiamą išsamią informaciją apie tai, ką padarėte (problemas galite nurodyti naudodami „#“). Dabar pateikite traukimo užklausą.

Sveikiname! Pateikėte savo pirmąją užklausą.  

Jei jūsų užklausa bus priimta, gausite el. Laišką.

7. Sinchronizuokite šakuotą pagrindinę šaką

Prieš pateikdami traukimo užklausas į pradinę saugyklą, turite sinchronizuoti savo saugyklą su pradine.

Net jei neketinate pateikti užklausos į pradinę saugyklą, geriau ją sinchronizuoti su originalia saugykla, nes kai kurios papildomos funkcijos ir klaidų taisymai galėjo būti atlikti, nes jūs sutvarkėte originalią saugyklą.

Atlikite šiuos veiksmus, kad atnaujintumėte / sinchronizuotumėte tuos pakeitimus savo pagrindiniame filiale:

  1. Pirmiausia patikrinkite, kuriame filiale esate.
$ git branch

Jame bus išvardytos visos šakos ir žalia arba dabartinė arba aktyvi atšaka.

2. Perjunkite į pagrindinę šaką.

$ git checkout master

3. Pridėkite originalią saugyklą kaip ankstesnę saugyklą.

Jei norite iš pirminės saugyklos pakeisti savo šakotą versiją, turite pridėti originalią „Git“ saugyklą kaip ankstesnę saugyklą.

$ git remote add upstream [HTTPS]

Čia [HTTPS] yra URL, kurį turite nukopijuoti iš savininko saugyklos.

4. Atsisiųskite saugyklą.

Gaukite visus pakeitimus iš pradinės saugyklos. Įsipareigojimai originaliai saugyklai bus saugomi vietiniame filiale, vadinamame „upstream / master“.

$ git fetch upstream

5. Sujunkite jį.

Sujunkite pakeitimus iš ankstesnio / pagrindinio į savo pagrindinį šaką. Tai privers jūsų šakės pagrindinę šaką sinchronizuoti su ankstesne saugykla, neprarandant vietinių pakeitimų.

$ git merge upstream/master

6. Paspauskite pakeitimus į „GitHub“

Šiuo metu jūsų vietinis skyrius sinchronizuojamas su pirminio saugyklos pagrindiniu filialu. Jei norite atnaujinti „GitHub“ saugyklą, turite perkelti pakeitimus.

$ git push origin master

PASTABA: Sinchronizavę šakuotą pagrindinį šaką, galite pašalinti tą nuotolinį valdiklį, jei norite. Bet ir ateityje turėsite atnaujinti / sinchronizuoti saugyklą, todėl geriausia praktika ją išsaugoti.

$ git remote rm [Remote Name]

8. Ištrinkite nereikalingą šaką

Filialai kuriami specialiam tikslui. Kai šis tikslas bus pasiektas, tie filialai nėra būtini, todėl galite juos ištrinti.

$ git branch -d [Branch Name]

Taip pat galite ištrinti jos versiją iš „GitHub“.

git push origin --delete [Branch Name]

Išvada

„GitHub“ yra galingas įrankis valdyti versijų istoriją. Kiekvienas gali prisidėti prie atvirojo kodo projektų pateikdamas užklausas. Ne visada indėlis yra kodas - yra ir kitų būdų prisidėti.

Galiausiai turiu jums pasakyti, kad neturėtumėte jaudintis, jei jūsų prašymai pareikšti ieškinį bus atmesti. Prižiūrėtojai daug laiko praleidžia tobulindami savo projektus ir jie žino apie savo projektus daug daugiau nei mes. Taigi nesijaudinkite, jei jūsų užklausa nebus sujungta.

Būkite stiprūs, išlikite pozityvūs ir niekada nepasiduokite.

- Roy T. Bennett, „Šviesa širdyje“

Šis straipsnis iš pradžių buvo paskelbtas „Medium“.

Galite susisiekti ir susisiekti su manimi „Twitter“.

Nuolat prisidėkite prie atvirojo kodo pasaulio!