Kuinka tehdä ensimmäinen vetopyyntösi GitHubissa

Mikä on haarukka?

Kun rakastamme jonkun arkistoa ja haluamme sen olevan GitHub-tilillä, haaroitamme sitä, jotta voimme työskennellä sen kanssa erikseen.

Kun haaroitamme arkistoa, saamme instanssin koko arkistosta koko historiaansa. Haarukkaamisen jälkeen voimme tehdä mitä haluamme tehdä vaikuttamatta alkuperäiseen versioon.

Mikä on vetopyyntö?

Vetopyynnöt ovat tapa, jolla osallistumme ryhmähankkeisiin tai avoimen lähdekoodin projekteihin.

Esimerkiksi käyttäjä Harry haarautuu ThanoshanMV-arkistoon ja tekee muutoksia kyseiseen arkistoon. Nyt Harry voi tehdä vetopyynnön ThanoshanMV: lle, mutta ThanoshanMV: n on hyväksyttävä tai hylättävä se. Se on kuin sanoa: "ThanoshanMV, voisitko vetää muutokseni?"

Mitä tarkoittaa osallistua

Emme voi vain osallistua avoimen lähdekoodin projektiin koodilla, mutta voimme myös osallistua monilla muilla tavoilla. Joitakin näistä tavoista kuvataan alla.

Kuten 99xtechnology IT -yrityksen hakkeroinnin aloitusoppaassa sanotaan, voimme osallistua avoimen lähdekoodin projektiin seuraavilla tavoilla:

  1. Suunnittelu: Voit rakentaa projektin asettelut parantamaan sen käytettävyyttä, parantamaan projektin navigointia ja valikkoa käyttäjien tutkimusohjelmien perusteella, luomaan taidetta logoille tai t-paitoille ja tarjoamaan tyylin oppaita projektille.
  2. Kirjoittaminen: Voit kirjoittaa ja parantaa projektin dokumentaatiota tai kääntää dokumentaation, aloittaa projektin uutiskirjeen tai kirjoittaa opasohjelmia projektille ja kuratoida kohokohtia postituslistalta tai kuratoida kansion, jossa on esimerkkejä projektien käytöstä.
  3. Järjestäminen: Voit linkittää päällekkäisiä asioita, ehdottaa uusia numerotunnisteita, ehdottaa vanhojen avoimien ongelmien sulkemista ja esittää kysymyksiä äskettäin avatuista aiheista keskustelun eteenpäin viemiseksi.
  4. Auta muita: Vastaa avoimiin kysymyksiin liittyviin kysymyksiin, tutustu muiden lähettämiin koodeihin ja tarjoa mentori toiselle avustajalle.
  5. Koodaus: Auta ratkaisemaan kaikki avoimet kysymykset, kysy, tarjoatko uusia ominaisuuksia ja parantaa työkaluja ja testausta.

Tehdään ensimmäinen vetopyyntö!

Jos et ole kovin perehtynyt Git & GitHubiin, siirry Git & GitHubin aloittelijan oppaaseen.

1. Haaraa arkisto

Haarauta arkisto napsauttamalla sivun yläosassa olevaa haarukanappia. Tämä luo koko arkiston esiintymän tilillesi.

2. Kloonaa arkisto

Kun arkisto on tililläsi, kloonaa se koneellesi työskentelemään sen kanssa paikallisesti.

Kloonaa napsauttamalla kloonauspainiketta ja kopioimalla linkki.

Avaa pääte ja suorita seuraava komento. Se kloonaa arkiston paikallisesti.

$ git clone [HTTPS ADDRESS]

Nyt olemme perustaneet kopion päähaarasta pääprojektivarastosta.

Meidän on mentävä kyseiseen kloonattuun hakemistoon suorittamalla tämä komento:

$ cd [NAME OF REPOSITORY]

3. Luo haara

On hyvä käytäntö luoda uusi sivuliike työskenneltäessä arkistojen kanssa, olipa kyseessä pieni projekti tai osallistuminen ryhmän työhön.

Sivuliikkeen nimen tulisi olla lyhyt ja sen tulisi heijastaa tekemäämme työtä.

Luo nyt haara git checkoutkomennolla:

$ git checkout -b [Branch Name]

4. Tee muutokset ja sitoutu niihin

Tee olennaiset muutokset projektiin ja tallenna se.

Suorita sitten git statusja näet muutokset.

Lisää nämä muutokset haaraan, jonka loit juuri git addkomennolla:

$ git add .

Tee nyt nämä muutokset git commitkomennolla:

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

5. Siirrä muutokset GitHubiin

Jotta voimme siirtää muutokset GitHubiin, meidän on tunnistettava kaukosäätimen nimi.

$ git remote

Tämän tietovaraston kaukosäätimen nimi on ”alkuperä”.

Tunnistettuamme kaukosäätimen nimen voimme työntää nämä muutokset turvallisesti GitHubiin.

git push origin [Branch Name]

6. Luo vetopyyntö

Siirry GitHub-arkistoon ja näet painikkeen "Vertaa ja vedä pyyntö" ja napsauta sitä.

Anna tarvittavat tiedot tekemistäsi (Voit viitata ongelmiin käyttämällä # -merkkiä). Lähetä nyt vetopyyntö.

Onnittelut! Olet tehnyt ensimmäisen vetopyyntösi.  

Jos vetopyyntösi hyväksytään, saat sähköpostin.

7. Synkronoi haarautunut päähaara

Ennen kuin lähetät vetopyyntöjä alkuperäiseen arkistoon, sinun on synkronoitava arkisto alkuperäiseen.

Vaikka et aio lähettää vetopyyntöä alkuperäiseen arkistoon, on parempi synkronoida alkuperäisen arkiston kanssa, koska joitain lisäominaisuuksia ja virhekorjauksia on voitu tehdä sen jälkeen, kun haaroitit alkuperäisen arkiston.

Noudata näitä vaiheita päivittääksesi / synkronoidaksesi muutokset päähaaraan:

  1. Tarkista ensin, missä haarassa olet.
$ git branch

Siinä luetellaan kaikki haarat ja osoitetaan nykyinen tai aktiivinen haara vihreällä.

2. Vaihda päähaaraan.

$ git checkout master

3. Lisää alkuperäinen arkisto ylävirtaan.

Jotta muutokset voidaan viedä alkuperäisestä arkistosta haarautuneeseen versioon, sinun on lisättävä alkuperäinen Git-arkisto ylävirtaan.

$ git remote add upstream [HTTPS]

Tässä [HTTPS] on URL-osoite, joka sinun on kopioitava omistajan arkistosta.

4. Hae arkisto.

Hae kaikki muutokset alkuperäisestä arkistosta. Sitoumukset alkuperäiseen arkistoon tallennetaan paikalliseen haaraan, jota kutsutaan ylävirtaan / päälliköksi.

$ git fetch upstream

5. Yhdistä se.

Yhdistä muutokset ylävirtaan / masterista paikalliseen master-haaraan. Tämä tuo haarukan päähaaran synkronoitumaan alkupään tietovaraston kanssa menettämättä paikallisia muutoksia.

$ git merge upstream/master

6. Siirrä muutokset GitHubiin

Tässä vaiheessa paikallinen haarasi synkronoidaan alkuperäisen arkiston päähaaraan. Jos haluat päivittää GitHub-arkiston, sinun on siirrettävä muutokset.

$ git push origin master

HUOMAUTUS: Haarautuneen päähaaran synkronoinnin jälkeen voit poistaa kaukosäätimen, jos haluat. Mutta sinun on päivitettävä / synkronoitava tietovarastosi myös jatkossa, joten kannattaa säilyttää se.

$ git remote rm [Remote Name]

8. Poista tarpeeton haara

Haarat perustetaan erityistä tarkoitusta varten. Kun tämä tarkoitus on saavutettu, nuo oksat eivät ole välttämättömiä, joten voit poistaa ne.

$ git branch -d [Branch Name]

Voit poistaa sen version myös GitHubista.

git push origin --delete [Branch Name]

Johtopäätös

GitHub on tehokas työkalu hallita versiohistoriaa. Jokainen voi osallistua avoimen lähdekoodin projekteihin tekemällä vetopyyntöjä. Avustukset eivät aina ole koodeja - myös muilla tavoilla voi osallistua.

Lopuksi minun on sanottava sinulle, että sinun ei pitäisi huolehtia, jos vetopyyntösi hylätään. Ylläpitäjät viettävät paljon aikaa projektien parantamiseen, ja he tietävät paljon enemmän projekteistaan ​​kuin me. Joten älä huoli, jos pyyntösi ei ole yhdistetty.

Pysy vahvana, pysy positiivisena äläkä koskaan anna periksi.

- Roy T.Bennett, Valo sydämessä

Tämä artikkeli julkaistiin alun perin Medium-sivustossa.

Voit ottaa yhteyttä minuun Twitterissä.

Jatka osallistumista avoimen lähdekoodin maailmaan!