Kuidas teha GitHubis esimene tõmbenõue

Mis on hargnemine?

Kui me armastame kellegi hoidlat ja soovime, et see oleks meie GitHubi kontol, siis me kahveldame seda, et saaksime sellega eraldi töötada.

Hoidla hargnemisel saame kogu selle hoidla eksemplari kogu ajalooga. Pärast hargnemist võime teha kõike, mida tahame, ilma et see mõjutaks algset versiooni.

Mis on tõmbetaotlus?

Tõmbetaotlused on viis, kuidas panustame grupiprojektidesse või avatud lähtekoodiga projektidesse.

Näiteks haarab kasutaja Harry ThanoshanMV hoidla ja muudab selles hoidlas muudatusi. Nüüd saab Harry esitada ThanoshanMV-le tõmbenõude, kuid ThanoshanMV peab selle vastu võtma või tagasi lükkama. See on nagu öeldes: "ThanoshanMV, kas palun tõmbaksite minu muudatusi?"

Mida tähendab panustamine

Me ei saa mitte ainult koodiga panustada avatud lähtekoodiga projekti, vaid ka mitmel muul viisil. Mõnda neist viisidest on kirjeldatud allpool.

Nagu öeldakse 99xtechnology IT-ettevõtte häkkimise alustamise juhendis, saame avatud lähtekoodiga projektile kaasa aidata järgmistel viisidel:

  1. Kujundus: saate koostada projekti paigutusi, et parandada selle kasutatavust, parandada projekti navigeerimist ja menüüd kasutajauuringuprogrammide põhjal, luua kunsti logode või t-särkide jaoks ning pakkuda projekti stiilijuhiseid.
  2. Kirjutamine: saate kirjutada ja täiendada projekti dokumentatsiooni või tõlkida dokumentatsiooni, alustada projekti infolehte või kirjutada projekti õpetusi ja kureerida esiletõstetud postiloendist või kureerida kausta näidete kohta, mis näitavad, kuidas projekte kasutatakse.
  3. Korrastamine: Arutelu edasiliikumiseks saate linkida dubleerivaid probleeme, soovitada uusi väljalaske silte, soovitada sulgeda vanu avatud küsimusi ja esitada küsimusi hiljuti avatud probleemide kohta.
  4. Aidake teisi: vastake avatud küsimuste küsimustele, vaadake üle teiste inimeste esildiste kood ja pakkuge teise kaasautori juhendamist.
  5. Kodeerimine: aidake lahendada kõik lahtised probleemid, küsige, kas saate pakkuda uusi funktsioone ning kuidas parandada tööriistu ja testimist.

Teeme oma esimese tõmbenõude!

Kui te pole Git & GitHubi eriti kursis, vaadake palun Git & GitHubi algajate juhend.

1. Kahvli hoidla

Hoidke hoidla, klõpsates lehe ülaosas asuvat kahvli nuppu. See loob teie kontole kogu selle hoidla eksemplari.

2. Kloonige hoidla

Kui hoidla on teie kontol, kloonige see oma arvutisse, et sellega kohapeal töötada.

Kloonimiseks klõpsake kloonimisnuppu ja kopeerige link.

Avage terminal ja käivitage järgmine käsk. See kloonib hoidla kohapeal.

$ git clone [HTTPS ADDRESS]

Nüüd oleme loonud peamise haru koopia peamisest veebiprojektide hoidlast.

Peame minema selle kloonitud kataloogi, käivitades selle käsu:

$ cd [NAME OF REPOSITORY]

3. Loo haru

Hea tava on luua hoidlatega töötades uus haru, olgu see siis väike projekt või panus rühma töösse.

Filiaali nimi peaks olema lühike ja see peaks kajastama meie tööd.

Nüüd looge haru git checkoutkäsuga:

$ git checkout -b [Branch Name]

4. Tehke muudatused ja siduge need

Tehke projektis olulised muudatused ja salvestage see.

Seejärel käivitage git statusja näete muudatusi.

Lisage need muudatused äsja loodud harule git addkäsuga:

$ git add .

Tehke need muudatused git commitkäsuga:

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

5. Lükake muudatused GitHubi

GitHubi muudatuste edastamiseks peame tuvastama kaugjuhtimispuldi nime.

$ git remote

Selle hoidla puhul on kaugjuhtimispuldi nimi päritolu.

Pärast kaugjuhtimispuldi nime tuvastamist saame need muudatused turvaliselt GitHubi lükata.

git push origin [Branch Name]

6. Loo tõmbenõue

Minge oma GitHubi hoidlasse ja näete nuppu „Võrdle ja tõmba taotlust“ ja klõpsake sellel.

Esitage vajalik teave selle kohta, mida olete teinud (probleemidele saate viidata, kasutades nuppu "#"). Nüüd esitage tõmbetaotlus.

Palju õnne! Olete esitanud oma esimese tõmbenõude.  

Kui teie tõmbetaotlus on vastu võetud, saate meili.

7. Sünkroonige oma kahvliharu

Enne kõigi päringute esitamist algsesse hoidlasse peate sünkroonima oma hoidla algsega.

Isegi kui te ei kavatse tõmmata päringut esialgsesse hoidlasse, on parem sünkroonida algse hoidlaga, kuna mõned lisafunktsioonid ja veaparandused võivad olla tehtud pärast algse hoidla hargnemist.

Nende muudatuste värskendamiseks / sünkroonimiseks oma peaharus toimige järgmiselt.

  1. Esmalt kontrollige, millises harus olete.
$ git branch

See loetleb kõik oksad ja näitab praegust või aktiivset haru roheliselt.

2. Lülitage põhiharu.

$ git checkout master

3. Lisage alghoidla ülesvoolu hoidlana.

Muudatuste tõmbamiseks algsest hoidlast oma hargnevasse versiooni peate lisama algse Giti hoidla ülesvoolu hoidlana.

$ git remote add upstream [HTTPS]

Siin on [HTTPS] URL, mille peate omaniku hoidlast kopeerima.

4. Too hoidla.

Too kõik muudatused algsest hoidlast. Algse hoidla kohustused salvestatakse kohalikus harus, mida nimetatakse ülesvoolu / masteriks.

$ git fetch upstream

5. Ühendage see.

Ühendage muudatused varasemast / peamisest oma kohalikuks haruks. See viib teie kahvli põhiharu sünkroonima ülesvooluhoidlaga, kaotamata teie kohalikke muudatusi.

$ git merge upstream/master

6. Lükake muudatused GitHubi

Sel hetkel sünkroonitakse teie kohalik haru algse hoidla peaharuga. Kui soovite värskendada GitHubi hoidlat, peate oma muudatused edasi lükkama.

$ git push origin master

MÄRKUS. Pärast hargnenud peaharu sünkroonimist võite soovi korral selle puldi eemaldada. Kuid peate ka tulevikus oma hoidlat värskendama / sünkroonima, nii et selle säilitamine on parim tava.

$ git remote rm [Remote Name]

8. Kustutage mittevajalik haru

Filiaalid luuakse eriotstarbeliselt. Kui see eesmärk on täidetud, pole neid harusid vaja, nii et saate need kustutada.

$ git branch -d [Branch Name]

Selle versiooni saate kustutada ka GitHubis.

git push origin --delete [Branch Name]

Järeldus

GitHub on võimas tööriist versiooniajaloo juhtimiseks. Kõik saavad avatud lähtekoodiga projektidesse panustada, tehes tõmbenõudeid. Kaastööd ei ole alati koodid - panustamiseks on ka muid viise.

Lõpuks pean teile ütlema, et te ei peaks muretsema, kui teie tõmbetaotlused tagasi lükatakse. Hooldajad kulutavad oma projektide täiustamiseks palju aega ja nad teavad oma projektidest palju rohkem kui meie. Nii et ärge muretsege, kui teie taotlust ei ühendata.

Ole tugev, püsi positiivne ja ära anna kunagi alla.

- Roy T. Bennett, Valgus südames

See artikkel postitati algselt keskmisele.

Võite minuga Twitteris ühendust võtta ja minuga ühendust võtta.

Panustage jätkuvalt avatud lähtekoodiga maailma!