Mchango wa Kwanza

Ni vigumu. Mara zote ni vigumu kufanya kitu kwa mara ya kwanza. Hasa kama unashirikiana na wengine, kufanya makosa sio jambo la kushangaza. Tulitaka kurahisisha namna ambavyo wachangiaji wapya wa mifumo ya wazi wanavyojifunza na kuchangia kwa mara ya kwanza.

Kusoma makala na kuangalia mafunzo ya video yaweza kusaidia, lakini ni jambo lipi bora zaidi kuliko kufanya kwa vitendo katika mazingira ya kujifunzia? Mradi huu unalenga kutoa mwongozo na kurahisisha namna ambavyo wachangiaji wapya wanavyoweza kuchangia kwa mara ya kwanza. Ikiwa unataka kuchangia kwa mara ya kwanza , fuata hatua zifuatazo.

Kama haujazoea kutumia 'command line', [waweza kutumia GUI.](#Makala ya namna ya kutumia nyenzo nyingine)

Kama hauna git kwenye kompyuta yako, pakua.

Tengeneza nakala ya hazina kwenye akaunti yako ya Github

Nakili(Fork) hazina hii kwa kubonyeza kitufe kilichopo juu ya ukurasa huu Kwa kufanya hivyo nakala ya hazina hii itatengenezwa kwenye akaunti yako ya Github.

Tengeneza nakala ya hazina kwenye kompyuta yako

Sasa clone hazina kwenye kompyuta yako. Nenda kwenye akaunti yako ya Github bonyeza kitufe kilichoandikwa clone na baada ya hapo bonyeza kitufe kilichoandikwa copy to clipboard.

Fungua terminal >_ kwenye kompyuta yako kisha amri ifuatayo:

git clone "kiungio-ulicho-nakili-github"

Kiungio hicho kinapatikana kwenye hatua ya kupakua nakala(clone), hakikisha unaondoa fungua semi na funga semi.

Kwa mfano:

git clone https://github.com/jina-lako-unalotumia-Github/first-contributions.git

Kwa kufanya hivyo utakuwa umenakili first-contributions hazina kutoka Github kwenda kwenye kompyuta yako.

Tengeneza tawi:

Kwenye kompyuta yako, ukiwa kwenye terminal ingia kwenye hazina uliyonakili

cd first-contributions

Sasa tengeneza tawi kwa kutumia amri ifuatayo git checkout amri:

git checkout -b <jina-la-tawi-jipya>

Kwa mfano:

git checkout -b hariri-majina-ya-wachangiaji

(Jina la tawi sio lazima lianze na neno ongeza.)

Fanya mabadiliko na baada ya hapo commit:

Sasa fungua faili linaloitwa Contributors.md, Andika jina lako. Usiweke jina lako mwanzoni au mwishoni mwa faili. Weka sehemu yoyote katikati. Baada ya hapo save faili.

Ukiwa ndani ya directory hii kwenye terminal amri ya git status itakuonesha mabadiliko yote uliyoyafanya.

Jumuisha mabadiliko yote uliyoyafanya kwenye tawi uliyotengeneza kwa kutumia amri git add amri:

git add Contributors.md

Sasa commit mabadiliko uliyoyafanya kwa kutumia amri ya git commit:

git commit -m "Ongeza <jina> kwenye orodha ya wachangiaji"

Badilisha neno <jina> na jina lako.

Tuma mabadiliko uliyoyafanya kwenda Github

Tuma mabadiliko uliyoyafanya kwa kutumia amri ya git push:

git push origin <jina-la-tawi>

Badilisha <jina-la-tawi> na jina la tawi ulilotengeneza hapo awali.

Kusanya mabadiliko uliyoyafanya kwa ajili ya uhakiki

Ukiwa Github kwenye hazina hii utaona kitufe kilichoandikwa Compare & pull request. Bonyeza kitufe hicho.

Sasa tuma pull request.

Haitochukua muda mrefu nitaanza kuchukua mabadiliko yaliyofanyika na kuyapeleka kwenye master tawi ya mradi huu. Utapokea email kukujulisha mara tu hatua hii itakapokamilika.

Nini cha kufanya baada ya hapa?

Hongera! Umeweza kumaliza hatua za msingi ambazo ni nakili-> pakua nakala -> hariri -> omba muunganiko ambazo utakutana nazo mara nyingi ukiwa kama mchangiaji!

Sherehekea hatua uliyofikia na wajulishe wengine kwa kwenda kwenye wavuti.

Waweza kujiunga na kundi letu la slack endapo utakuwa unahitaji msaada wowote. Jiunge na kundi letu la slack.

Sasa tuanze kuchangia kwenye miradi mingine. Tumekusanya orodha ya miradi ambayo ina mambo mepesi unayoweza kuanza kushughulika nayo. Angalia Orodha ya miradi.