Simpleng tutorial upang gawin ang iyong unang PR (Hilahin ang Kahilingan)

Sa gayon, ang isang ito sa palagay ko ay magiging isang maikling maikling tutorial at inaasahan kong didaktiko;). Gagawa ako ng isang maliit na lalagyan na magagamit sa iyo sa aking github upang maipadala mo ang iyong mga PR at sa parehong oras upang maaari mong sanayin kung paano gawin ang lahat ng mga hakbang na maiiwan ko sa ibaba. Narito ang link upang gawin ang iyong pagsubok na PR:

https://github.com/CodeLabora/TuPrimerPR

Kaya, mabilis nating ilista ang mga hakbang na kinakailangan upang magpadala ng isang PR:

1. Tinidor
2. I-clone ang
3. Malayo
4. Sangay
5. Mga Pagbabago
6. Idagdag
7. gumawa
8. Itulak
9. PR

Inilalagay ko sila sa Ingles upang makita nila ang kani-kanilang mga pagpipilian sa git command line.

Tinidor

Ang isang tinidor ay ang iyong sariling bersyon ng isang imbakan ng Github. Pinapayagan ka nitong i-clone ang gawain ng ibang proyekto at ilagay ito sa iyong account upang mabago mo ang mga bagay nang hindi nag-aalala tungkol sa pagkawala ng iyong mga pagbabago. Upang makagawa ng isang tinidor kinakailangan lamang na pumunta sa pahina at mag-click sa pindutan ng Fork na nasa kanang itaas na bahagi.

Kapag tapos na ang tinidor, makikita mo na ang lalagyan ay lilitaw sa iyong account.

I-clone ang

Ngayon na mayroon kaming isang imbakan ay i-clone namin ito sa aming koponan. (Ipinapalagay ko na ang mga taong gumagamit ng Linux ay sumusunod sa akin, ngunit para sa mga gumagamit ng iba pang mga system mayroon ding mga bersyon ng git na maaari nilang i-download sa kanilang opisyal na pahina.

At sa aming terminal ginagawa namin ang sumusunod.

Sa pamamagitan nito magkakaroon kami ng isang bagong folder na tinatawag na TuPrimerPR kung saan naroon ang aming proyekto sa Github. Ipasok namin ang folder na may utos «cd TuPrimerPR» at makikita namin na nasa loob ang mga file na nasa aming tinidor.

(Tandaan na ang bilang ng mga file ay maaaring mag-iba depende sa kung ano ang mahahanap nila sa aking imbakan kapag tinidor sila)

Malayo

Ito ay isang opsyonal na hakbang, ngunit ang isa na iniiwasan ang maraming mga problema kapag patuloy na nagtatrabaho sa isang proyekto. Ang tinidor sa pamamagitan ng default ay lumilikha ng isang eksaktong kopya ng imbakan, ngunit sa eksaktong sandali ng paglikha. Nangangahulugan ito na kung ang proyekto ay nagpapatuloy na sumulong, ang iyong imbakan ay mahuhuli sa paglipas ng mga araw o oras. Pinapayagan kami ng "Git remote" na tukuyin ang isa pang punto ng pag-download (ang orihinal na proyekto) at sa gayon ay ma-update ang aming proyekto sa tuwing nakikita namin na ina-update ang proyekto ng magulang.

Upang mahanap ang iyong proyekto sa magulang, kailangan mo lamang gamitin ang link na nasa ibaba lamang ng pangalan ng iyong lalagyan. (Suriin ang pangalawang imahe ng seksyon ng Fork). Idaragdag namin ang impormasyong ito sa ibaba:

Ito ang orihinal na proyekto (tatawagin namin ito salungat sa agos upang makasabay sa maraming mga proyekto).

Tulad ng nakikita mo, naidagdag ko ang remote sa »git remote add »

Sa pamamagitan nito magagawa naming i-update ang proyekto kung kinakailangan, ngunit hindi namin ito gagamitin ngayon dahil hindi ito kinakailangan. (Ipapaliwanag ko iyon sa paglaon, o sa ibang post, depende sa pangangailangan)

Sangay

Pinapayagan ka ng mga sangay (o mga sangay) na lumikha ng mga seksyon ng code na maaari mong gumana sa isang nakahiwalay na kapaligiran. Nangangahulugan ito na ang ginagawa mo sa isang sangay ay hindi kinakailangang nakakaapekto sa orihinal na code hanggang sa magamit ang isang »git merge«. Ito rin ay isang labis na pag-andar na pinapayagan ka ng Github, sa tuwing lumilikha ka ng isang sangay, awtomatikong bubuo ang Github ng mapagkukunan ng Hilagang Hiling kung kinakailangan.

Ngayon na nasa aming espesyal na sangay kami, maaari kaming magtrabaho sa aming kontribusyon.

Mga Pagbabago

Magdaragdag ako ng ilang mga file upang makita mo kung paano ito tapos.

Pinapayagan kami ng "Touch" na lumikha ng isang blangko na file (kung wala ito). sa pamamagitan nito maaari tayong magpatuloy sa susunod nating hakbang.

Idagdag

Pinapayagan kami ng »Git add» na magdagdag ng mga file sa aming pangako (Ipagpapaliwanag ko sa paglaon). Upang makita kung anong mga file ang maaari mong idagdag maaari mong gamitin ang utos »git status»

Sa pamamagitan nito mayroon kaming lahat na handa para sa aming Pangako

gumawa

Ang mga pangako ay marka (o milestones) sa oras. tinutukoy nila ang isang estado para sa lahat ng mga file sa proyekto at naipon ang mga pagbabagong kinakailangan upang makuha mula sa simula ng proyekto hanggang sa kasalukuyang estado. Ito ay medyo kumplikado, ngunit ito ay medyo simple, tandaan lamang na sila ang mga hagdan ng iyong proyekto. Nagsusulat kami »git commit» at makakakuha kami ng isang window upang isulat ang aming mensahe sa pangako.

At kapag tinatapos at nai-save ang teksto, makakakita kami ng tulad ng:

Kung saan ipinakita ang isang buod ng kung ano ang ginagawa.

Itulak

Sa pamamagitan ng push na ina-upload namin sa aming Github account ang lahat ng mga pangako na mayroon kami sa computer na wala sa aming lalagyan sa internet. Papayagan nito ang Github na awtomatikong makabuo ng bagong PR.

Pansinin na ginagamit namin ang pangalan ng aming sangay at hinihiling nito sa amin ang aming username at password. Sa huli ipinapakita nito sa amin na ang myImprove branch ay nilikha sa loob ng aming Github account. Tingnan natin kung ano ang nakamit natin sa browser. 😉

PR

Tulad ng nakikita mo, isang bagong linya ang nilikha na nagsasabing "Ihambing at Hilingin ang kahilingan". Pinapayagan kami ng pagpapaandar ng Github na lumikha ng PR sa isang simpleng paraan, mag-click kami upang makita kung ano ang mangyayari.

Si Github ay medyo matalino. Tulad ng nakikita mo, ang mga bahagi ng paggawa ay idinagdag sa form para sa pagsusumite. Kinakailangan lamang na mag-click sa pindutan at voila 🙂 Simple.

dagdag

Nasa likod ito ng mga proyekto, lilitaw ang PR at nagpasya ang tagapamahala kung tatanggapin o hindi, o magsulat ng higit pang mga mensahe. Sa aking kaso tatanggapin ko ito kaagad.

Kapag natapos na ang pagsasama, makikita nila ang gumawa log ng proyekto at makita ang kanilang pangalan dito.

Ngunit ngayon mayroon kaming problema. Ang komit na iyon ay hindi lilitaw sa aming repository, sa proyekto lamang. Naaalala mo ba ang aming malalayong daanan? Ngayon ay kung kailan ito magbabayad 🙂

Bumalik kami sa aming master branch at gawin ang mga sumusunod:

Sa pamamagitan nito nai-download namin ang lahat ng impormasyon ng orihinal na proyekto sa aming koponan. Tulad ng nakikita mo, lilitaw doon ang aming pagsumite. Ngayon ay i-save namin ang lahat ng gawaing ito sa aming imbakan ng Github upang matanggal ang sangay na may kontribusyon na naidagdag na nila sa proyekto.

Ngayon na mayroon kaming na-update na Repository ng Github tatanggalin namin ang aming sangay, ngunit tinitiyak muna namin na nasa loob ito ng aming pangunahing sangay (master)

Tulad ng nakikita mong mayroon akong kaunting pagkakamali, ito ay dahil nasa aking my branch ako ng Pag-ayos nang gusto kong tanggalin. Ito ay naayos sa pamamagitan ng pagbabalik sa master branch.

Konklusyon

Tapos na 🙂 kasing simple ng na. Ngayon na pinagkadalubhasaan mo ang madilim na mga lihim ng Github para sa pagpapadala ng PR, inaasahan kong makita ang iyong mga kontribusyon sa iba't ibang mga proyekto. At kung nais mo maiiwan mo ang iyong unang PR sa aking lalagyan 😉 upang matandaan.

Hindi ko pa nahawakan ang isang libo at isang Git na mga benepisyo (MATA, hindi Github) at tulad ng aasahan mo mula sa mga developer na nakatali sa komunidad ng kernel, ang Git ay isang napakalakas na tool, na may daan-daang mga tampok.

Upang makakuha ng isang mas mahusay na ideya kung ano ang ginagawa nito at lahat ng lakas ng Git, lubos kong inirerekumenda ito libro. Sigurado akong makakatulong ito sa iyo upang mapagbuti ang iyong paghawak ng git.

Pagbati at sana makatulong ito sa iyo 😉