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.
Soma hii kwa lugha zingine.
๐ฎ๐ณ ๐ฒ๐ฒ ๐ฎ๐ฉ ๐ซ๐ท ๐ช๐ธ ๐ณ๐ฑ ๐ฑ๐น ๐ท๐บ ๐ธ๐ฐ ๐ฏ๐ต ๐ป๐ณ ๐ต๐ฑ ๐ฎ๐ท ๐ฎ๐ท ๐ฐ๐ท ๐ฐ๐ต ๐ฉ๐ช ๐ฉ๐ฐ ๐จ๐ณ ๐น๐ผ ๐ฌ๐ท ๐ช๐ฌ ๐ธ๐ฆ ๐บ๐ฆ ๐ง๐ท ๐ต๐น ๐ฎ๐น ๐น๐ญ ๐ด ๐ต๐ฐ ๐ง๐ฉ ๐ฒ๐ฉ ๐ท๐ด ๐น๐ท ๐ธ๐ช ๐ธ๐ฎ ๐ฎ๐ฑ ๐จ๐ฟ ๐ฒ๐ฝ ๐ฟ๐ฆ ๐ฟ๐ฆ ๐ฐ๐ช ๐ณ๐ฌ
Futa repo hii kwa kubonyeza kifungo cha fakia juu ya ukurasa huu. Hii itaunda nakala ya hifadhi hii katika akaunti yako.
Sasa fungia repo iliyofungwa kwa mashine yako. Nenda kwenye akaunti yako ya GitHub, kufungua repo iliyofungwa, bonyeza kitufe cha kamba na kisha bofya nakala kwenye clipboardboard .
Fungua terminal na uendesha amri yafuatayo 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
wapi this-is-you
jina lako la mtumiaji GitHub. Hapa unakili nakala ya maudhui ya kwanza ya michango kwenye GitHub kwenye kompyuta yako.
Badilisha kwenye saraka ya uhifadhi kwenye kompyuta yako (ikiwa huko tayari):
cd first-contributions
Sasa uunda 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.)
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 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.
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.
Hongera! Wewe umekamilisha fomu ya kawaida -> clone -> hariri -> PRflowflow 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.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code |
Ikiwa ulipenda mradi huu, nyota kwenye GitHub. Ikiwa unasikia hasa zawadi, fuata Roshan kwenye Twitter na GitHub.