Kako podnijeti prvi zahtjev za povlačenjem na GitHubu

Što je račvanje?

Kada volimo nečije spremište i željeli bismo ga imati na svom GitHub računu, rastavimo ga tako da s njim možemo raditi zasebno.

Kada rastavimo spremište, dobivamo primjerak cijelog tog spremišta s cijelom njegovom poviješću. Nakon račvanja, možemo raditi sve što želimo bez utjecaja na izvornu verziju.

Što je zahtjev za povlačenjem?

Zahtjevi za povlačenje način su na koji doprinosimo grupnim projektima ili projektima otvorenog koda.

Na primjer, korisnik Harry račva spremište ThanoshanMV-a i unosi promjene u to spremište. Sada Harry može uputiti zahtjev za povlačenje ThanoshanMV-u, ali na ThanoshanMV-u je da ga prihvati ili odbije. To je kao da kažete: "ThanoshanMV, hoćete li molim vas povući moje promjene?"

Što znači doprinositi

Ne samo da možemo pridonijeti projektu otvorenog koda s kodom, već možemo doprinijeti i na mnoge druge načine. Neki od ovih načina opisani su u nastavku.

Kao što kaže vodič za pokretanje hacktitude IT tvrtke 99xtechnology, projektu otvorenog koda možemo pridonijeti na sljedeće načine:

  1. Dizajniranje: Možete izraditi izgled projekta kako biste poboljšali njegovu iskoristivost, poboljšali navigaciju i izbornik na temelju programa za istraživanje korisnika, stvorili umjetnost za logotipe ili majice i pružili stilske vodiče za projekt.
  2. Pisanje: Možete napisati i poboljšati projektnu dokumentaciju ili prevesti dokumentaciju, pokrenuti bilten za projekt ili napisati vodiče za projekt i pripremiti najvažnije dijelove s mailing liste ili urediti mapu primjera koji pokazuju kako se projekti koriste.
  3. Organiziranje: Možete povezati dvostruke izdanja, predložiti nove oznake izdanja, predložiti zatvaranje starih otvorenih izdanja i postavljati pitanja o nedavno otvorenim izdanjima kako biste pokrenuli raspravu naprijed.
  4. Pomozite drugima: odgovorite na pitanja o otvorenim pitanjima, pregledajte kod na tuđim prijavama i ponudite mentorstvo drugom suradniku.
  5. Kodiranje: pomozite riješiti sve otvorene probleme, pitajte možete li pružiti nove značajke i poboljšati alate i testiranje.

Napravimo prvi zahtjev za povlačenjem!

Ako niste dobro upoznati s Git & GitHubom, posjetite Vodič za početnike za Git & GitHub.

1. Razdvojite spremište

Razdvojite spremište klikom na gumb račvanja na vrhu stranice. To će stvoriti instancu cijelog tog spremišta na vašem računu.

2. Klonirajte spremište

Jednom kad se spremište nađe na vašem računu, klonirajte ga na svoj stroj da lokalno radi s njim.

Da biste klonirali, kliknite gumb za kloniranje i kopirajte vezu.

Otvorite terminal i pokrenite sljedeću naredbu. Lokalno će klonirati spremište.

$ git clone [HTTPS ADDRESS]

Sada smo postavili kopiju glavne grane iz glavnog mrežnog spremišta projekata.

Moramo otići do tog kloniranog direktorija izvođenjem ove naredbe:

$ cd [NAME OF REPOSITORY]

3. Stvorite granu

Dobra je praksa stvoriti novu granu kada radite s spremištima, bilo da se radi o malom projektu ili doprinosu radu grupe.

Naziv podružnice trebao bi biti kratak i trebao bi odražavati posao koji radimo.

Sada stvorite granu pomoću git checkoutnaredbe:

$ git checkout -b [Branch Name]

4. Unesite promjene i izvršite ih

Unesite bitne promjene u projekt i spremite ga.

Zatim izvršite git statusi vidjet ćete promjene.

Dodajte te promjene u granu koju ste upravo stvorili pomoću git addnaredbe:

$ git add .

Sada izvršite te promjene pomoću git commitnaredbe:

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

5. Pritisnite promjene na GitHubu

Da bismo potaknuli promjene na GitHub, moramo identificirati ime daljinskog upravljača.

$ git remote

Za ovo spremište naziv daljinskog upravljača je "izvor".

Nakon identificiranja imena daljinskog upravljača možemo sigurno ugurati te promjene u GitHub.

git push origin [Branch Name]

6. Stvorite zahtjev za povlačenjem

Idite u svoje spremište na GitHubu i vidjet ćete gumb "Usporedi i povuci zahtjev" i kliknite ga.

Navedite potrebne detalje o tome što ste učinili (probleme možete uputiti pomoću "#"). Sada pošaljite zahtjev za povlačenjem.

Čestitamo! Napravili ste prvi zahtjev za povlačenjem.  

Ako je vaš zahtjev za povlačenjem prihvaćen, primit ćete e-poštu.

7. Sinkronizirajte svoju račvastu glavnu granu

Prije podnošenja zahtjeva za povlačenjem u izvorno spremište morate sinkronizirati svoje spremište s izvornim spremištem.

Čak i ako nećete predati zahtjev za povlačenje izvornom spremištu, bolje je sinkronizirati se s izvornim spremištem jer su možda izvršene neke dodatne značajke i ispravci programskih pogrešaka otkako ste račvali izvorno spremište.

Slijedite ove korake za ažuriranje / sinkronizaciju tih promjena u glavnoj grani:

  1. Prvo provjerite u kojoj ste poslovnici.
$ git branch

Popisat će sve grane i označiti trenutnu ili aktivnu granu zelenom bojom.

2. Prebacite se na glavnu granu.

$ git checkout master

3. Dodajte izvorno spremište kao uzlazno spremište.

Da biste povukli promjene iz izvornog spremišta u vašu račvastu verziju, morate dodati originalno Git spremište kao uzvodno spremište.

$ git remote add upstream [HTTPS]

Ovdje je [HTTPS] URL koji morate kopirati iz spremišta vlasnika.

4. Dohvati spremište.

Dohvati sve promjene iz izvornog spremišta. Predaje u izvorno spremište pohranit će se u lokalnoj grani koja se zove upstream / master.

$ git fetch upstream

5. Spoji ga.

Spojite promjene s gornje / glavne u vašu lokalnu matičnu granu. To će sinhronizirati matičnu granu vaše vilice s spremištem uzvodno, bez gubitka lokalnih promjena.

$ git merge upstream/master

6. Promjene pritisnite na GitHub

U ovom se trenutku vaša lokalna grana sinkronizira s glavnom granom izvornog spremišta. Ako želite ažurirati spremište GitHub, trebate pritisnuti promjene.

$ git push origin master

NAPOMENA: Nakon sinkronizacije račvaste glavne grane možete ukloniti taj daljinski upravljač ako želite. Ali i u budućnosti ćete morati ažurirati / sinkronizirati svoje spremište, pa je najbolje zadržati ga.

$ git remote rm [Remote Name]

8. Izbrišite nepotrebnu granu

Podružnice se stvaraju za posebnu namjenu. Kad se ta svrha postigne, te grane nisu potrebne, pa ih možete izbrisati.

$ git branch -d [Branch Name]

Verziju istog možete izbrisati i na GitHubu.

git push origin --delete [Branch Name]

Zaključak

GitHub je moćan alat za kontrolu povijesti verzija. Svatko može pridonijeti projektima otvorenog koda podnošenjem zahtjeva za povlačenjem. Doprinosi nisu uvijek kod - postoje i drugi načini za doprinos.

Na kraju, moram vam reći da ne biste trebali brinuti ako se vaši zahtjevi za povlačenjem odbiju. Održavači provode puno vremena poboljšavajući svoje projekte i o svojim projektima znaju puno više od nas. Stoga se ne brinite ako vaš zahtjev nije spojen.

Ostanite jaki, budite pozitivni i nikad ne odustajte.

- Roy T. Bennett, Svjetlost u srcu

Ovaj je članak prvotno objavljen na Medijumu.

Možete me kontaktirati i povezati sa mnom na Twitteru.

Nastavite doprinositi svijetu otvorenog koda!