README.kws.md

Mchango wa Kwanza

Ni vigumu. Ni vigumu daima mara ya kwanza unafanya kitu. Hasa wakati unashirikiana, kufanya makosa sio jambo la kushangaza. Tulitaka kurahisisha njia mpya ya wafadhili wa kujifunza na kuchangia kwa mara ya kwanza.

Kusoma makala na mafunzo ya kutazama yanaweza kusaidia, lakini ni nini bora zaidi kuliko kufanya mambo halisi katika mazingira ya mazoezi? Mradi huu unalenga kutoa mwongozo na kurahisisha wasanidi wa njia kufanya mchango wao wa kwanza. Ikiwa unatafuta kufanya mchango wako wa kwanza, fuata hatua zifuatazo.

Ikiwa huna urahisi na mstari wa amri, hapa ni mafunzo kwa kutumia zana za GUI.

Vuta hifadhi hii

Vuta repo hii kwa kubonyeza kifungo cha fakia juu ya ukurasa huu. Hii itaunda nakala ya hifadhi hii katika akaunti yako.

Weka chumba

Sasa nakala repo iliyovutwa kwa mashine yako. Nenda kwenye akaunti yako ya GitHub, fungua repo iliyovutwa, bonyeza kitufe cha kamba na kisha bofya nakala kwenye clipboard.

Fungua terminal na uendesha amri yafuatayo:

git clone "url you just copied"

ambapo "url ulikosa tu" (bila alama za kupiga kura) ni url kwenye hifadhi hii (fomu yako ya mradi huu). Angalia hatua za awali ili kupata url.

Kwa mfano:

git clone https://github.com/this-is-you/first-contributions.git

hapo this-is-youtumia jina lako la mtumiaji GitHub. Hapa unakili nakala ya maudhui ya kwanza ya michango kwenye GitHub kwenye kompyuta yako.

Unda tawi

Badilisha kwenye saraka ya uhifadhi kwenye kompyuta yako (ikiwa huko tayari):

cd first-contributions

Sasa unda tawi kwa kutumia git checkout amri:

git checkout -b <add-your-new-branch-name>

Kwa mfano:

git checkout -b add-alonzo-church

(Jina la tawi haina haja ya kuwa neno liongeze ndani yake, lakini ni jambo la kuzingatia kwa sababu lengo la tawi hili ni kuongeza jina lako kwenye orodha.)

Fanya mabadiliko muhimu na ufanyie mabadiliko hayo

Sasa fungua Contributors.md faili katika mhariri wa maandishi, uongeze jina lako. Usiongeze kwenye mwanzo au mwisho wa faili. Weka mahali popote katikati. Sasa, sahau faili.

Ikiwa unakwenda kwenye saraka ya mradi na kutekeleza amri git status, utaona kuna mabadiliko.

Ongeza mabadiliko hayo kwenye tawi ulilojenga kwa kutumia git add amri:

git add Contributors.md

Sasa fanya mabadiliko hayo kwa kutumia amri git commit:

git push origin <add-your-branch-name>

kubadilisha <your-name> jina lako.

Skuma mabadiliko kwenye GitHub

Skuma mabadiliko yako kwa kutumia amri git push:

git push origin <add-your-branch-name>

kubadilisha <add-your-branch-name> na jina la tawi uliloumba hapo awali.

Tuma mabadiliko yako kwa ukaguzi

Ikiwa unaenda kwenye hifadhi yako kwenye GitHub, utaona Compare & pull request kifungo. Bofya kwenye kifungo hicho.

Sasa weka ombi la kuvuta.

Hivi karibuni nitakuwa kuunganisha mabadiliko yako yote kwenye tawi la mradi huu. Utapata barua pepe ya arifa mara mabadiliko yameunganishwa.

Wapi kutoka hapa?

Hongera! Wewe umekamilisha fomu ya kawaida fork -> clone -> hariri -> pull request ambayo unakutana mara nyingi kama mchangiaji!

Sherehe mchango wako na uwashiriki na marafiki zako na wafuasi kwa kwenda kwenye programu ya wavuti.

Unaweza kujiunga na timu yetu ya slack ikiwa unahitaji msaada wowote au una maswali yoyote. Jiunge na timu ya slack.

Sasa hebu tuanze uanze na kuchangia kwenye miradi mingine. Tumeandika orodha ya miradi na masuala rahisi unaweza kuanza. Angalia orodha ya miradi katika programu ya wavuti.

Nyenzo za ziada

Mafundisho Kutumia Zana Zingine

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code	Atlassian Sourcetree	IntelliJ IDEA