GitHub ni nini na jinsi ya kuitumia

GitHub ni kipande cha programu inayotumiwa sana na timu za ukuzaji programu, kwa udhibiti wa toleo la ukuzaji.

Ni muhimu wakati zaidi ya mtu mmoja anafanya kazi kwenye mradi.

Kwa mfano, tuseme timu ya wasanidi programu wanataka kujenga tovuti na wote wanahitaji kusasisha msimbo, wakati huo huo, wakati wa kufanya kazi kwenye mradi. Katika hali hii, Github husaidia kuunda hazina ya kati ambapo kila mtu anaweza kupakia, kuhariri, na kudhibiti faili za msimbo wa programu.

Kabla ya kuanza kutumia GitHub, unahitaji kuunda akaunti GitHub.

Repository

Hifadhi kawaida hutumiwa kupanga mradi wa programu ya programu. Hifadhi zinaweza kuwa na folda na faili, picha, video, lahajedwali na seti za data - kila kitu ambacho mradi wako unahitaji. Mara nyingi hazina hujumuisha faili ya README, faili yenye taarifa kuhusu mradi wako.

Faili za README zimeandikwa kwa lugha ya Markdown kwa maandishi wazi. Unaweza kushauriana ukurasa huu web kama rejeleo la haraka la lugha ya Markdown. GitHub hukuruhusu kuongeza faili ya README wakati huo huo unapounda hazina yako mpya. GitHub pia hutoa chaguzi zingine za kawaida kama vile faili ya leseni, lakini hauitaji kuchagua yoyote mwanzoni.

Ili kuunda hazina mpya, chagua kwenye menyu upande wa juu kulia New repository. Endelea na hatua zifuatazo:

1. Katika kona ya juu kulia ya ukurasa wowote, tumia menyu kunjuzi na uchague New repository.

1. Katika kisanduku cha Jina la Hifadhi, ingiza first-repository.
2. Katika kisanduku cha Maelezo, andika maelezo mafupi.
3. Chagua Ongeza faili ya README.
4. Chagua kama hazina yako itakuwa ya umma au ya faragha.
5. Bonyeza Create repository.

Kuunda tawi

Kuunda tawi hukuruhusu kuwa na matoleo kadhaa ya hazina kwa wakati mmoja.

Kwa chaguo-msingidefinita, hazina first-repository ina tawi linaloitwa main ambayo inachukuliwa kuwa tawi defiasili. Unaweza kuunda matawi ya ziada ili kuu kwenye hazina first-repository. Unaweza kutumia matawi kuwa na matoleo tofauti ya mradi kwa wakati mmoja. Hii ni muhimu unapotaka kuongeza utendaji mpya kwa mradi bila kubadilisha msimbo mkuu wa chanzo. Kazi iliyofanywa kwenye matawi tofauti haitaonekana kwenye tawi kuu hadi uiunganishe. Unaweza kutumia matawi kufanya majaribio na kufanya mabadiliko kabla ya kuyakabidhi kuu.

Unapounda tawi kutoka kwa tawi kuu, unatengeneza nakala, au muhtasari, wa kuu kama ilivyokuwa wakati huo. Ikiwa mtu mwingine angefanya mabadiliko kwenye tawi kuu ulipokuwa unafanya kazi kwenye tawi lako, unaweza kusukuma masasisho hayo.

Katika mchoro ufuatao tunaweza kuona:

Tawi kuu
Tawi jipya liliitwa feature
Njia ambayo feature hufanya kabla ya kuunganishwa na kuu

Kuunda tawi kwa utekelezaji mpya au kurekebisha hitilafu ni kama kuhifadhi faili. Kwa GitHub, wasanidi programu hutumia matawi kuweka urekebishaji wa hitilafu, na vipengele vya kazi, tofauti na tawi kuu la uzalishaji. Wakati mabadiliko iko tayari, huunganishwa kwenye tawi kuu.

Wacha tuunde tawi

Baada ya kuunda hazina yetu, nenda kwenye kichupo <>Code(1) ya hazina:

Bofya menyu kuu (2) kunjuzi, kisha upe ile mpya jina branch (3)

Bonyeza Create branch: first branch from 'main'

Sasa tuna mbili branch, main e first-branch. Hivi sasa, wanaonekana sawa kabisa. Baadaye tutaongeza mabadiliko kwa mpya branch.

Fanya na uthibitishe mabadiliko

Imeunda mpya tu branch, GitHub ilikuleta kwenye code page kwa mpya first-branch, ambayo ni nakala kuu.

Tunaweza kufanya na kuhifadhi mabadiliko kwenye faili kwenye hazina. Kwenye GitHub, mabadiliko yaliyohifadhiwa yanaitwa commit. Kila commit ina ujumbe kutoka commit kuhusishwa, ambayo ni maelezo yanayoeleza kwa nini mabadiliko fulani yalifanywa. Ujumbe wa commit wananasa historia ya mabadiliko ili wachangiaji wengine waelewe nini kilifanyika na kwanini.

Chini ya tawi first-branch imeundwa, bofya kwenye faili ya README.md, na kisha kwenye penseli ili kuhariri faili.

Katika hariri, andika kwa kutumia Markdown.

Kwenye sanduku Commit changes (Preview), tunaandika ujumbe wa commit kuelezea mabadiliko.

Hatimaye bonyeza kifungo Commit changes.

Mabadiliko haya yatafanywa kwa faili ya README pekee first-branch, kwa hivyo sasa tawi hili lina yaliyomo tofauti na ile kuu.

Ufunguzi wa moja pull request

Sasa kwa kuwa tuna mabadiliko katika tawi mbali kuu, tunaweza kufungua moja pull request.

Le pull request ndio moyo wa ushirikiano kwenye GitHub. Unapofungua a pull request, unapendekeza mabadiliko yako na unaomba mtu afanye a review e pull ya mchango wako na kuwaunganisha katika tawi lao. The pull request onyesha tofauti za maudhui ya matawi yote mawili. Mabadiliko, nyongeza na kupunguza huonyeshwa kwa rangi tofauti.

Mara tu unapofanya ahadi, unaweza kufungua ombi la kuvuta na kuanza majadiliano, hata kabla ya msimbo kukamilika.

Kwa kutumia kipengele @mention kutoka kwa GitHub kwenye chapisho lako kutoka pull request, unaweza kuuliza watu mahususi au timu kwa maoni, bila kujali eneo lao.

Unaweza hata kufungua pull request kwenye hazina yako na uziunganishe mwenyewe. Ni njia nzuri ya kujifunza mkondo wa GitHub kabla ya kufanya kazi kwenye miradi mikubwa.

Kufanya moja pull request unapaswa:

• Bofya kwenye kichupo pull request ya hazina yako first-repository.

• Bonyeza New pull request
• Katika sanduku Example Comparisons, chagua tawi ulilounda, first-branch, kulinganishwa na kuu (ya asili).
• Kagua mabadiliko yako katika tofauti kwenye ukurasa wa Linganisha, hakikisha kuwa ndizo unazotaka kuwasilisha.

• Bonyeza Create pull request.

• Ipe chako cheo pull request andika maelezo mafupi ya mabadiliko yako. Unaweza kujumuisha emoji na buruta na udondoshe picha na gif.

• Kwa hiari, upande wa kulia wa kichwa na maelezo, bofya karibu na Wakaguzi. Wapokeaji, Lebo, Miradi au Mafanikio ya kuongeza mojawapo ya chaguo hizi kwenye yako pull request. Huna haja ya kuziongeza bado, lakini chaguo hizi hutoa njia kadhaa za kushirikiana kwa kutumia yako pull request.
• Bonyeza Create pull request.

Washiriki wako sasa wanaweza kukagua mabadiliko yako na kutoa mapendekezo.

Unganisha yako pull request

Katika hatua hii ya mwisho, utaunganisha tawi lako first-branch katika tawi kuu. Baada ya kuunganisha pull request, mabadiliko kwenye tawi first-branch itapachikwa kwenye faili kuu.

Wakati mwingine, ombi la kuvuta linaweza kutambulisha mabadiliko ya msimbo ambayo yanakinzana na msimbo uliopo kwenye main. Ikiwa kuna migogoro yoyote, GitHub itakuonya kuhusu msimbo unaokinzana na kuzuia uunganisho huo hadi mizozo isuluhishwe. Unaweza kufanya ahadi ambayo itasuluhisha mizozo au kutumia maoni katika ombi la kuvuta ili kujadili migogoro na washiriki wa timu yako.

• Bonyeza Merge pull request kuunganisha mabadiliko kuwa kuu.

• Bonyeza Confirm merge. Utapokea ujumbe kwamba ombi liliunganishwa kwa ufanisi na ombi limefungwa.
• Bonyeza Delete branch. Sasa hiyo yako richiesta pull imeunganishwa na mabadiliko yako yamewashwa, unaweza kufuta tawi kwa usalama first-branch. Ikiwa ungependa kufanya mabadiliko zaidi kwa mradi wako, unaweza kuunda tawi jipya kila wakati na kurudia mchakato huu.

Ercole Palmeri