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 repo hii kwa kubonyeza kifungo cha fakia juu ya ukurasa huu. Hii itaunda nakala ya hifadhi hii katika akaunti yako.
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-you
tumia 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 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.)
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 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.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |