Udhëzim i thjeshtë për të bërë PR-në tuaj të parë (Tërhiqni Kërkesën)

Epo, ky mendoj se do të jetë një tutorial mjaft i shkurtër dhe shpresojmë se është didaktik;). Unë do të bëj një depo të vogël të disponueshme për ju në github tim, në mënyrë që të dërgoni PR tuaj dhe në të njëjtën kohë në mënyrë që të mund të praktikoni se si të bëni të gjitha hapat që do të lë më poshtë. Këtu është lidhja për të bërë provën tuaj PR:

https://github.com/CodeLabora/TuPrimerPR

Epo, le të rendisim shpejt hapat e nevojshëm për të dërguar një PR:

1. Pirun
2. Klon
3. I largët
4. Degë
5. ndryshimet
6. Shtoj
7. Kryej
8. Shtytje
9. PR

Unë po i vë në anglisht në mënyrë që ata të gjejnë opsionet e tyre përkatëse në rreshtin e komandave git.

Pirun

Një pirun është versioni juaj i një depoje Github. Kjo ju lejon të klononi punën e një projekti tjetër dhe ta keni atë në llogarinë tuaj në mënyrë që të mund të ndryshoni gjërat pa u shqetësuar për humbjen e ndryshimeve tuaja. Për të bërë një pirun është e nevojshme vetëm të shkoni në faqe dhe të klikoni në butonin Fork që ndodhet në pjesën e sipërme të djathtë.

Sapo të kryhet piruni, do të shihni se depoja shfaqet në llogarinë tuaj.

Klon

Tani që kemi një depo do ta klonojmë atë tek ekipi ynë. (Supozoj se njerëzit që përdorin Linux më ndjekin, por për përdoruesit e sistemeve të tjera ka edhe versione të git që mund t'i shkarkoni në faqen e tyre zyrtare.

Dhe me terminalin tonë ne bëjmë sa vijon.

Me këtë do të kemi një dosje të re të quajtur TuPrimerPR në të cilën do të jetë projekti ynë Github. Ne futemi në dosje me komandën «cd TuPrimerPR» dhe do të shohim se brenda janë skedarët që janë në pirunin tonë.

(Vini re se numri i skedarëve mund të ndryshojë në varësi të asaj që ata gjejnë në depon time kur ato pirun)

I largët

Ky është një hap opsional, por shmang shumë probleme kur punoni vazhdimisht në një projekt. Fork si parazgjedhje krijon një kopje të saktë të depozitës, por në momentin e saktë të krijimit. Kjo do të thotë që nëse projekti vazhdon të përparojë, depoja juaj do të mbetet prapa me kalimin e ditëve ose orëve. "Git remote" na lejon të specifikojmë një pikë tjetër të shkarkimit (projekti origjinal) dhe kështu të jemi në gjendje të azhurnojmë projektin tonë sa herë që shohim se projekti prind po azhurnohet.

Për të gjetur projektin tuaj prind, ju thjesht duhet të përdorni lidhjen që është vetëm nën emrin e depozitës tuaj. (Kontrolloni imazhin e dytë të seksionit Fork). Ne do të shtojmë këtë informacion më poshtë:

Ky është projekti origjinal (ne do ta quajmë atë në rrjedhën e sipërme për të vazhduar me shumë projekte).

Siç mund ta shihni, unë kam shtuar telekomandën me »git remote add »

Me këtë ne do të jemi në gjendje të azhurnojmë projektin kur është e nevojshme, por nuk do ta përdorim tani sepse nuk është e nevojshme. (Do ta shpjegoj më vonë, ose në një post tjetër, varësisht nga nevoja)

Degë

Degët (ose degët) ju lejojnë të krijoni pjesë të kodit që mund të punoni në një mjedis të izoluar. Kjo do të thotë që ajo që bëni në një degë nuk ndikon domosdoshmërisht në kodin origjinal derisa të përdoret një »bashkim git«. Alsoshtë gjithashtu një funksionalitet shtesë që ju lejon Github, sa herë që krijoni një degë, Github gjeneron automatikisht burimin e Kërkesës Tërheqëse kur është e nevojshme.

Tani që jemi në degën tonë të veçantë, mund të punojmë për kontributin tonë.

ndryshimet

Do të shtoj disa skedarë që të mund të shihni se si është bërë.

"Prekja" na lejon të krijojmë një skedar të zbrazët (nëse nuk ekziston). me këtë ne mund të kalojmë në hapin tonë të ardhshëm.

Shtoj

»Git add» na lejon të shtojmë skedarë në angazhimin tonë (do ta shpjegoj më vonë). Për të parë se cilat skedarë mund të shtoni, mund të përdorni komandën »statusi i git»

Me këtë ne kemi gjithçka gati për angazhimin tonë

Kryej

Kryerjet janë shenja (ose momente historike) në kohë. ato përcaktojnë një gjendje për të gjitha skedarët në projekt dhe grumbullojnë ndryshimet e nevojshme për të marrë nga fillimi i projektit në gjendjen aktuale. Duket paksa komplekse, por është mjaft e thjeshtë, thjesht mos harroni se ato janë shkallët e projektit tuaj. Ne shkruajmë »git kryer» dhe do të kemi një dritare për të shkruar mesazhin tonë të kryer.

Dhe kur të mbaroni dhe ruani tekstin, do të shohim diçka si:

Aty ku tregohet një përmbledhje e asaj që bën zotimi.

Shtytje

Me shtytje po ngarkojmë në llogarinë tonë Github të gjitha zotimet që kemi në kompjuter që nuk janë në depon tonë në internet. Kjo do të lejojë që Github të gjenerojë PR e re automatikisht.

Vini re se ne jemi duke përdorur emrin e degës sonë dhe se ajo na kërkon emrin e përdoruesit dhe fjalëkalimin tonë. Në fund na tregon se dega myImprovement është krijuar brenda llogarisë tonë Github. Le të shohim se çfarë kemi arritur në shfletuesin. 😉

PR

Siç mund ta shihni, është krijuar një linjë e re që thotë "Krahasoni dhe Tërhiqni kërkesën". Ky funksionalitet i Github na lejon të krijojmë PR në një mënyrë të thjeshtë, ne do të klikojmë për të parë se çfarë do të ndodhë.

Github është mjaft i zgjuar. Siç mund ta shihni, pjesë të angazhimit shtohen në formularin për dorëzim. Necessaryshtë e nevojshme vetëm të klikoni butonin dhe voila 🙂 E thjeshtë.

shtesë

Kjo është prapa skenave të projekteve, shfaqet PR dhe menaxheri vendos nëse do të pranojë ose jo, ose të shkruajë më shumë mesazhe. Në rastin tim unë do ta pranoj menjëherë.

Sapo të bëhet bashkimi, ata mund të shohin regjistrin e angazhimeve të projektit dhe të shohin emrin e tyre në të.

Por tani kemi një problem. Ky kryer nuk shfaqet në tonë depo, vetëm në projekt. A ju kujtohet kalimi ynë i largët? Tani është kur të paguajë

Ne kthehemi në degën tonë master dhe bëjmë sa vijon:

Me këtë ne kemi shkarkuar të gjithë informacionin e projektit origjinal në ekipin tonë. Siç mund ta shihni, angazhimi ynë shfaqet atje. Tani do të ruajmë gjithë këtë punë në depon tonë Github për të qenë në gjendje të fshijmë degën që ka kontributin që ata tashmë i shtuan projektit.

Tani që kemi deponinë tonë të azhurnuar Github do të fshijmë degën tonë, por së pari sigurohemi që ajo të jetë brenda degës sonë kryesore (master)

Siç mund ta shihni, unë kisha një gabim të lehtë, kjo ishte sepse isha në degën time të Përmirësimit kur doja të fshija. Kjo rregullohet duke u kthyer në degën master.

Përfundim

Bërë 🙂 aq e thjeshtë sa ajo. Tani që keni zotëruar sekretet e errëta të Github për dërgimin e PR, mezi pres të shoh kontributet tuaja në projekte të ndryshme. Dhe nëse dëshironi, mund ta lini PR tuaj të parë në magazinën time 😉 për kujtesën.

Unë nuk kam prekur një mijë e një përfitime të Git (Sy, jo Github) dhe siç do të prisnit nga zhvilluesit që janë të lidhur me bashkësinë e bërthamave, Git është një mjet jashtëzakonisht i fuqishëm, me qindra funksionalitete.

Në mënyrë që të kemi një ide më të mirë se çfarë bën dhe gjithë fuqinë e Git, unë e rekomandoj shumë këtë libër. Jam i sigurt që do t'ju ndihmojë shumë për të përmirësuar trajtimin tuaj të git.

Përshëndetje dhe shpresoj të të ndihmojë