37 KiB

Raw Blame History Unescape Escape

Utangulizi wa GitHub

Habari, mtaalamu wa baadaye! 👋 Uko tayari kujiunga na mamilioni ya waandaaji programu duniani? Nimefurahi sana kukutambulisha kwa GitHub – fikiria kama mtandao wa kijamii kwa waandaaji programu, isipokuwa badala ya kushiriki picha za chakula chako cha mchana, tunashiriki misimbo na kujenga mambo ya ajabu pamoja!

Hili ndilo linanivutia sana: kila programu kwenye simu yako, kila tovuti unayotembelea, na zana nyingi utakazojifunza kutumia zilitengenezwa na timu za waandaaji programu wakishirikiana kwenye majukwaa kama GitHub. Hiyo programu ya muziki unayoipenda? Mtu kama wewe alichangia kuijenga. Hiyo mchezo usiyoweza kuacha kucheza? Ndio, labda ilijengwa kwa ushirikiano wa GitHub. Na sasa WEWE unakwenda kujifunza jinsi ya kuwa sehemu ya jamii hiyo ya ajabu!

Najua hii inaweza kuonekana kama mengi mwanzoni – kwa kweli, nakumbuka nilipotazama ukurasa wangu wa kwanza wa GitHub nikifikiria "Hii yote ina maana gani?" Lakini jambo ni hili: kila mtaalamu wa programu alianza mahali ulipo sasa. Mwishoni mwa somo hili, utakuwa na hifadhi yako mwenyewe ya GitHub (fikiria kama maonyesho ya mradi wako binafsi mtandaoni), na utajua jinsi ya kuhifadhi kazi yako, kushiriki na wengine, na hata kuchangia miradi inayotumiwa na mamilioni ya watu.

Tutachukua safari hii pamoja, hatua kwa hatua. Hakuna haraka, hakuna shinikizo – ni wewe, mimi, na zana za kuvutia ambazo zitakuwa marafiki zako wapya wa karibu!

Sketchnote na Tomomi Imura

Maswali ya Awali ya Somo

Maswali ya awali ya somo

Utangulizi

Kabla ya kuingia kwenye mambo ya kusisimua, hebu tuandae kompyuta yako kwa ajili ya uchawi wa GitHub! Fikiria hili kama kupanga vifaa vyako vya sanaa kabla ya kuunda kazi ya sanaa – kuwa na zana sahihi tayari hufanya kila kitu kuwa rahisi na cha kufurahisha zaidi.

Nitakutembeza hatua kwa hatua katika kila hatua ya maandalizi, na naahidi siyo ngumu kama inavyoonekana mwanzoni. Ikiwa kuna kitu hakieleweki mara moja, ni kawaida kabisa! Nakumbuka nilipokuwa naandaa mazingira yangu ya kwanza ya maendeleo na kuhisi kama nilikuwa najaribu kusoma maandishi ya kale. Kila mtaalamu wa programu amewahi kuwa mahali ulipo sasa, akijiuliza kama anafanya sawa. Siri ni kwamba: ikiwa uko hapa unajifunza, tayari unafanya sawa! 🌟

Katika somo hili, tutajadili:

kufuatilia kazi unayofanya kwenye kompyuta yako
kufanya kazi kwenye miradi na wengine
jinsi ya kuchangia programu za chanzo huria

Mahitaji ya Awali

Hebu tuandae kompyuta yako kwa ajili ya uchawi wa GitHub! Usijali – maandalizi haya ni kitu unachohitaji kufanya mara moja tu, na kisha utakuwa tayari kwa safari yako yote ya programu.

Sawa, hebu tuanze na msingi! Kwanza, tunahitaji kuangalia kama Git tayari ipo kwenye kompyuta yako. Git kimsingi ni kama kuwa na msaidizi mwenye akili nyingi anayekumbuka kila mabadiliko unayofanya kwenye misimbo yako – bora zaidi kuliko kubonyeza Ctrl+S kila sekunde mbili (sote tumewahi kufanya hivyo!).

Hebu tuone kama Git tayari imewekwa kwa kuandika amri hii ya kichawi kwenye terminal yako: git --version

Ikiwa Git bado haipo, usijali! Nenda tu kwenye download Git na ipakue. Mara tu unapokuwa umeiweka, tunahitaji kuitambulisha Git kwako vizuri:

💡 Maandalizi ya Mara ya Kwanza: Amri hizi zinaambia Git wewe ni nani. Taarifa hii itaambatanishwa na kila commit unayofanya, kwa hivyo chagua jina na barua pepe unayojisikia vizuri kushiriki hadharani.

git config --global user.name "your-name"
git config --global user.email "your-email"

Ili kuangalia kama Git tayari imewekwa unaweza kuandika:

git config --list

Pia utahitaji akaunti ya GitHub, mhariri wa misimbo (kama Visual Studio Code), na utahitaji kufungua terminal yako (au: command prompt).

Tembelea github.com na unda akaunti ikiwa bado huna, au ingia na ujaze wasifu wako.

💡 Ushauri wa Kisasa: Fikiria kuweka SSH keys au kutumia GitHub CLI kwa urahisi wa uthibitisho bila nywila.

✅ GitHub siyo hifadhi pekee ya misimbo duniani; kuna nyingine, lakini GitHub ndiyo inayojulikana zaidi.

Maandalizi

Utahitaji folda yenye mradi wa misimbo kwenye kompyuta yako ya ndani (laptop au PC), na hifadhi ya umma kwenye GitHub, ambayo itatumika kama mfano wa jinsi ya kuchangia miradi ya wengine.

Kuhifadhi Misimbo Yako Salama

Hebu tuzungumze kuhusu usalama kwa muda – lakini usijali, hatutakufanya uhisi kuzidiwa na mambo ya kutisha! Fikiria mazoea haya ya usalama kama kufunga gari lako au nyumba yako. Ni tabia rahisi zinazokuwa za kawaida na kulinda kazi yako ngumu.

Tutakuonyesha njia za kisasa, salama za kufanya kazi na GitHub tangu mwanzo. Kwa njia hii, utajenga tabia nzuri ambazo zitakusaidia vizuri katika kazi yako ya programu.

Unapofanya kazi na GitHub, ni muhimu kufuata mazoea bora ya usalama:

Eneo la Usalama	Mazoea Bora	Kwa Nini Ni Muhimu
Uthibitisho	Tumia SSH keys au Personal Access Tokens	Nywila si salama sana na zinatolewa
Uthibitisho wa Hatua Mbili	Washa 2FA kwenye akaunti yako ya GitHub	Inaongeza safu ya ziada ya ulinzi wa akaunti
Usalama wa Hifadhi	Usikubali taarifa nyeti	Funguo za API na nywila hazipaswi kuwa kwenye hifadhi za umma
Usimamizi wa Vitegemezi	Washa Dependabot kwa masasisho	Inahakikisha vitegemezi vyako ni salama na vimesasishwa

⚠️ Kumbusho Muhimu la Usalama: Usikubali funguo za API, nywila, au taarifa nyingine nyeti kwenye hifadhi yoyote. Tumia mazingira ya kutofautisha na faili za .gitignore kulinda data nyeti.

Maandalizi ya Kisasa ya Uthibitisho:

# Generate SSH key (modern ed25519 algorithm)
ssh-keygen -t ed25519 -C "your_email@example.com"

# Set up Git to use SSH
git remote set-url origin git@github.com:username/repository.git

💡 Ushauri wa Wataalamu: SSH keys huondoa hitaji la kuingiza nywila mara kwa mara na ni salama zaidi kuliko njia za jadi za uthibitisho.

Kusimamia Misimbo Yako Kama Mtaalamu

Sawa, HII ndiyo sehemu ambapo mambo yanakuwa ya kusisimua sana! 🎉 Tunakaribia kujifunza jinsi ya kufuatilia na kusimamia misimbo yako kama wataalamu wanavyofanya, na kwa kweli, hii ni moja ya mambo ninayopenda kufundisha kwa sababu ni mabadiliko makubwa.

Fikiria hivi: unaandika hadithi ya kushangaza, na unataka kufuatilia kila rasimu, kila mabadiliko mazuri, na kila "subiri, hiyo ni nzuri!" wakati njiani. Hivyo ndivyo Git inavyofanya kwa misimbo yako! Ni kama kuwa na daftari la kusafiri kwa wakati ambalo linakumbuka KILA KITU – kila neno, kila mabadiliko, kila "oops, hiyo iliharibu kila kitu" ambalo unaweza kurekebisha mara moja.

Nitakuwa mkweli – hii inaweza kuhisi kuzidiwa mwanzoni. Nilipoanza, nilifikiria "Kwa nini siwezi tu kuhifadhi faili zangu kama kawaida?" Lakini niamini: mara Git itakapokufungukia (na itafunguka!), utakuwa na moja ya nyakati hizo za mwangaza ambapo unafikiria "Nilifanyaje programu bila hii?" Ni kama kugundua unaweza kuruka wakati umekuwa ukitembea kila mahali maisha yako yote!

Tuseme una folda ya ndani yenye mradi wa misimbo na unataka kuanza kufuatilia maendeleo yako ukitumia git - mfumo wa kudhibiti toleo. Watu wengine hulinganisha kutumia git na kuandika barua ya mapenzi kwa nafsi yako ya baadaye. Kusoma ujumbe wa commit siku, wiki, au miezi baadaye utaweza kukumbuka kwa nini ulifanya uamuzi, au "kurudisha nyuma" mabadiliko - yaani, unapokuwa unaandika ujumbe mzuri wa "commit".

Kazi: Unda Hifadhi Yako ya Kwanza!

🎯 Dhamira Yako (na ninasisimka kwa ajili yako!): Tunakwenda kuunda hifadhi yako ya kwanza ya GitHub pamoja! Kufikia mwisho wa hapa, utakuwa na kona yako ndogo ya mtandao ambapo misimbo yako inaishi, na utakuwa umefanya "commit" yako ya kwanza (hiyo ni lugha ya waandaaji programu kwa kuhifadhi kazi yako kwa njia ya akili sana).

Hii ni wakati maalum sana – unakaribia kujiunga rasmi na jamii ya kimataifa ya waandaaji programu! Bado nakumbuka msisimko wa kuunda hifadhi yangu ya kwanza na kufikiria "Wow, kweli ninafanya hili!"

Hebu tuendelee na safari hii pamoja, hatua kwa hatua. Chukua muda wako kwa kila sehemu – hakuna zawadi kwa haraka, na naahidi kila hatua itakuwa na maana. Kumbuka, kila nyota wa programu unayempenda aliwahi kukaa mahali ulipo, akijiandaa kuunda hifadhi yake ya kwanza. Si hilo ni la kuvutia?

Tazama video

Hebu Tufanye Hili Pamoja:

Unda hifadhi yako kwenye GitHub. Nenda GitHub.com na tafuta kitufe cha kijani kibichi New (au alama ya + kwenye kona ya juu kulia). Bonyeza na uchague New repository.

Hivi ndivyo unavyofanya:
1. Peana hifadhi yako jina – lifanye kuwa na maana kwako!
2. Ongeza maelezo ikiwa unataka (hii husaidia wengine kuelewa mradi wako unahusu nini)
3. Amua ikiwa unataka iwe ya umma (kila mtu anaweza kuiona) au ya binafsi (kwa ajili yako tu)
4. Ninapendekeza kuangalia kisanduku cha kuongeza faili ya README – ni kama ukurasa wa mbele wa mradi wako
5. Bonyeza Create repository na sherehekea – umeunda hifadhi yako ya kwanza! 🎉
Elekea kwenye folda ya mradi wako. Sasa hebu tufungue terminal yako (usijali, si ya kutisha kama inavyoonekana!). Tunahitaji kuambia kompyuta yako mahali faili za mradi wako zipo. Andika amri hii:
```
cd [name of your folder]
```
Tunachofanya hapa:
- Kimsingi tunasema "Hey kompyuta, nipeleke kwenye folda ya mradi wangu"
- Hii ni kama kufungua folda maalum kwenye desktop yako, lakini tunafanya kwa amri za maandishi
- Badilisha [name of your folder] na jina halisi la folda ya mradi wako
Geuza folda yako kuwa hifadhi ya Git. Hapa ndipo uchawi unapotokea! Andika:
```
git init
```
Hapa ndipo kilichotokea (mambo ya kuvutia!):
- Git imeunda folda ya siri .git kwenye mradi wako – huwezi kuiona, lakini ipo!
- Folda yako ya kawaida sasa ni "hifadhi" inayoweza kufuatilia kila mabadiliko unayofanya
- Fikiria kama kutoa folda yako nguvu za kipekee za kukumbuka kila kitu
Angalia kinachoendelea. Hebu tuone Git inafikiria nini kuhusu mradi wako kwa sasa:
```
git status
```
Kuelewa kinachosemwa na Git:

Unaweza kuona kitu kinachoonekana kama hiki:
```
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)

     modified:   file.txt
     modified:   file2.txt
```
Usiogope! Hii inamaanisha:
- Faili za nyekundu ni faili ambazo zina mabadiliko lakini haziko tayari kuhifadhiwa bado
- Faili za kijani (ukiziona) ziko tayari kuhifadhiwa
- Git inakuwa msaada kwa kukuambia hasa unachoweza kufanya baadaye
💡 Ushauri wa Wataalamu: Amri ya git status ni rafiki yako bora! Tumia wakati wowote unapochanganyikiwa kuhusu kinachoendelea. Ni kama kuuliza Git "Hey, hali ikoje sasa?"
Andaa faili zako kwa kuhifadhi (hii inaitwa "staging"):
```
git add .
```
Tulichofanya:
- Tuliambia Git "Hey, nataka niweke FAILI ZOTE kwenye hifadhi inayofuata"
- . ni kama kusema "kila kitu kwenye folda hii"
- Sasa faili zako ziko "staged" na ziko tayari kwa hatua inayofuata
Unataka kuchagua zaidi? Unaweza kuongeza faili maalum tu:
```
git add [file or folder name]
```
Kwa nini unaweza kutaka kufanya hivi?
- Wakati mwingine unataka kuhifadhi mabadiliko yanayohusiana pamoja
- Inakusaidia kupanga kazi yako katika sehemu za kimantiki
- Inafanya iwe rahisi kuelewa kilichobadilika na lini
Umebadilisha mawazo? Usijali! Unaweza kuondoa faili kutoka kwa "staged" kama hivi:
```
# Unstage everything
git reset

# Unstage just one file
git reset [file name]
```
Usijali – hii haifuti kazi yako, inachukua tu faili kutoka kwenye "hifadhi inayofuata".
Hifadhi kazi yako milele (kutengeneza commit yako ya kwanza!):
```
git commit -m "first commit"
```
🎉 Hongera! Umefanya commit yako ya kwanza!

Hapa ndipo kilichotokea:
- Git ilichukua "picha" ya faili zako zote zilizowekwa kwenye hatua hii halisi
- Ujumbe wako wa commit "first commit" unaelezea kuhusu hatua hii ya kuhifadhi
- Git ilitoa ID ya kipekee kwa picha hii ili uweze kuipata wakati wowote baadaye
- Umeanza rasmi kufuatilia historia ya mradi wako!
💡 Ujumbe wa commit wa baadaye: Kwa commit zako zijazo, kuwa na maelezo zaidi! Badala ya "updated stuff", jaribu "Ongeza fomu ya mawasiliano kwenye ukurasa wa mwanzo" au "Rekebisha hitilafu ya menyu ya urambazaji". Nafsi yako ya baadaye itakushukuru!
Unganisha mradi wako wa ndani na GitHub. Kwa sasa, mradi wako upo tu kwenye kompyuta yako. Hebu tuunganishe na hifadhi yako ya GitHub ili uweze kushiriki na dunia!

Kwanza, nenda kwenye ukurasa wa hifadhi yako ya GitHub na nakili URL. Kisha rudi hapa na andika:
```
git remote add origin https://github.com/username/repository_name.git
```
(Badilisha URL hiyo na URL halisi ya hifadhi yako!)

Hapa ndipo kilichotokea:
- Tumeunda muunganisho kati ya mradi wako wa ndani na hifadhi yako ya GitHub
- "Origin" ni jina la utani tu kwa hifadhi yako ya GitHub – ni kama kuongeza mawasiliano kwenye simu yako
- Sasa Git yako ya ndani inajua wapi pa kutuma msimbo wako unapokuwa tayari kuushiriki
💡 Njia rahisi zaidi: Ikiwa umeweka GitHub CLI, unaweza kufanya hili kwa amri moja:
```
gh repo create my-repo --public --push --source=.
```
Tuma msimbo wako kwenye GitHub (wakati mkubwa!):
```
git push -u origin main
```
🚀 Hii ndiyo! Unapakia msimbo wako kwenye GitHub!

Kinachotokea:
- Mabadiliko yako yanatoka kwenye kompyuta yako kwenda GitHub
- Bendera ya -u inaweka muunganisho wa kudumu ili usukumo wa baadaye uwe rahisi
- "main" ni jina la tawi lako kuu (kama folda kuu)
- Baada ya hili, unaweza tu kuandika git push kwa upakiaji wa baadaye!
💡 Kumbuka haraka: Ikiwa tawi lako linaitwa kitu kingine (kama "master"), tumia jina hilo. Unaweza kuangalia kwa git branch --show-current.
Mpangilio wako mpya wa kila siku wa usimbaji (hapa ndipo inakuwa ya kuvutia!):

Kuanzia sasa, kila unapofanya mabadiliko kwenye mradi wako, una hatua hizi tatu rahisi za kufuata:
```
git add .
git commit -m "describe what you changed"
git push
```
Hii inakuwa mapigo ya moyo wa usimbaji wako:
- Fanya mabadiliko mazuri kwenye msimbo wako ✨
- Yape nafasi kwa git add ("Hey Git, zingatia mabadiliko haya!")
- Yahifadhi kwa git commit na ujumbe wa kuelezea (wewe wa baadaye atakushukuru!)
- Yashiriki na dunia kwa kutumia git push 🚀
- Rudia tena – kwa kweli, hii inakuwa ya kawaida kama kupumua!
Napenda mtiririko huu kwa sababu ni kama kuwa na sehemu nyingi za kuhifadhi katika mchezo wa video. Umefanya mabadiliko unayopenda? Yathibitishe! Unataka kujaribu kitu hatari? Hakuna shida – unaweza kurudi kwenye uhifadhi wako wa mwisho ikiwa mambo yataenda vibaya!

💡 Kidokezo: Unaweza pia kutaka kutumia faili ya .gitignore ili kuzuia faili ambazo hutaki kufuatilia zisionekane kwenye GitHub - kama faili ya maelezo unayohifadhi kwenye folda hiyo hiyo lakini haina nafasi kwenye hifadhi ya umma. Unaweza kupata templeti za faili za .gitignore kwenye .gitignore templates au kuunda moja kwa kutumia gitignore.io.

Mitiririko ya kisasa ya Git

Fikiria kutumia mbinu hizi za kisasa:

Conventional Commits: Tumia muundo wa ujumbe wa uhifadhi uliosimamiwa kama feat:, fix:, docs:, nk. Jifunze zaidi kwenye conventionalcommits.org
Atomic commits: Fanya kila uhifadhi uwakilishe mabadiliko moja ya kimantiki
Frequent commits: Hifadhi mara kwa mara na ujumbe wa kuelezea badala ya uhifadhi mkubwa, wa nadra

Ujumbe wa uhifadhi

Mstari mzuri wa somo la uhifadhi wa Git unakamilisha sentensi ifuatayo: Ikiwa itatumika, uhifadhi huu uta

Kwa somo tumia hali ya amri, wakati wa sasa: "badilisha" si "imebadilishwa" wala "inabadilisha". Kama ilivyo kwenye somo, kwenye mwili (hiari) pia tumia hali ya amri, wakati wa sasa. Mwili unapaswa kujumuisha motisha ya mabadiliko na kulinganisha hii na tabia ya awali. Unafafanua kwa nini, si jinsi.

✅ Chukua dakika chache kuzunguka GitHub. Je, unaweza kupata ujumbe mzuri wa uhifadhi? Je, unaweza kupata mmoja wa kiwango cha chini sana? Ni taarifa gani unadhani ni muhimu zaidi na ya manufaa kufikisha kwenye ujumbe wa uhifadhi?

Kufanya kazi na Wengine (Sehemu ya Kufurahisha!)

Shikilia kofia yako kwa sababu HII ndiyo ambapo GitHub inakuwa ya kichawi kabisa! 🪄 Umejifunza kusimamia msimbo wako mwenyewe, lakini sasa tunaingia kwenye sehemu ninayopenda zaidi – kushirikiana na watu wa ajabu kutoka kote ulimwenguni.

Fikiria hili: unaamka kesho na kuona kwamba mtu huko Tokyo ameboresha msimbo wako wakati ulikuwa umelala. Kisha mtu huko Berlin anarekebisha hitilafu ambayo umekuwa ukikwama nayo. Kufikia alasiri, msanidi programu huko São Paulo ameongeza kipengele ambacho hata hukuwahi kufikiria. Hiyo siyo hadithi ya kisayansi – hiyo ni Jumanne tu katika ulimwengu wa GitHub!

Kinachonifanya niwe na furaha sana ni kwamba ujuzi wa kushirikiana unaojifunza sasa? Hizi ni mbinu SAWA ambazo timu huko Google, Microsoft, na kampuni unazozipenda hutumia kila siku. Hujifunzi tu zana nzuri – unajifunza lugha ya siri inayofanya ulimwengu mzima wa programu kufanya kazi pamoja.

Kwa kweli, mara tu unapopata msisimko wa kuwa na mtu kuunganisha ombi lako la kwanza la kuvuta, utaelewa kwa nini wasanidi programu wanakuwa na shauku sana kuhusu chanzo wazi. Ni kama kuwa sehemu ya mradi mkubwa zaidi, wa ubunifu zaidi wa timu duniani!

Tazama video

Sababu kuu ya kuweka vitu kwenye GitHub ilikuwa kufanya iwezekane kushirikiana na wasanidi programu wengine.

Katika hifadhi yako, nenda kwenye Insights > Community ili kuona jinsi mradi wako unavyolinganishwa na viwango vya jamii vinavyopendekezwa.

Unataka kufanya hifadhi yako ionekane kitaalamu na ya kuvutia? Nenda kwenye hifadhi yako na bonyeza Insights > Community. Kipengele hiki kizuri kinaonyesha jinsi mradi wako unavyolinganishwa na kile jamii ya GitHub inachokiona kama "mazoea mazuri ya hifadhi."

🎯 Kufanya Mradi Wako Kung'aa: Hifadhi iliyoandaliwa vizuri na nyaraka nzuri ni kama kuwa na duka safi, la kuvutia. Inaonyesha watu kwamba unajali kazi yako na inawafanya wengine kutaka kuchangia!

Hivi ndivyo hifadhi inavyokuwa ya ajabu:

Kitu cha Kuongeza	Kwa Nini Ni Muhimu	Kinachokufanyia
Maelezo	Muonekano wa kwanza ni muhimu!	Watu wanajua mara moja mradi wako unafanya nini
README	Ukurasa wa mbele wa mradi wako	Kama mwongozo wa kirafiki kwa wageni wapya
Miongozo ya Kuchangia	Inaonyesha unakaribisha msaada	Watu wanajua hasa jinsi wanavyoweza kukusaidia
Kanuni za Maadili	Inaunda nafasi ya kirafiki	Kila mtu anahisi kukaribishwa kushiriki
Leseni	Uwazi wa kisheria	Wengine wanajua jinsi wanavyoweza kutumia msimbo wako
Sera ya Usalama	Inaonyesha unawajibika	Inaonyesha mazoea ya kitaalamu

💡 Kidokezo cha Kitaalamu: GitHub hutoa templeti za faili zote hizi. Unapounda hifadhi mpya, angalia masanduku ili kuunda faili hizi moja kwa moja.

Vipengele vya Kisasa vya GitHub vya Kuchunguza:

🤖 Otomatiki & CI/CD:

GitHub Actions kwa majaribio ya kiotomatiki na usambazaji
Dependabot kwa masasisho ya kiotomatiki ya utegemezi

💬 Jamii & Usimamizi wa Mradi:

GitHub Discussions kwa mazungumzo ya jamii zaidi ya masuala
GitHub Projects kwa usimamizi wa mradi wa mtindo wa kanban
Sheria za ulinzi wa tawi za kutekeleza viwango vya ubora wa msimbo

Rasilimali hizi zote zitasaidia kuingiza wanachama wapya wa timu. Na hizi ndizo kawaida vitu ambavyo wachangiaji wapya huangalia kabla hata ya kuangalia msimbo wako, ili kujua ikiwa mradi wako ni mahali sahihi pa kutumia muda wao.

✅ Faili za README, ingawa zinachukua muda kuandaa, mara nyingi hupuuzwa na waangalizi wenye shughuli nyingi. Je, unaweza kupata mfano wa moja iliyoelezea hasa? Kumbuka: kuna zana za kusaidia kuunda README nzuri ambazo unaweza kupenda kujaribu.

Kazi: Unganisha msimbo fulani

Nyaraka za kuchangia husaidia watu kuchangia mradi. Inaelezea ni aina gani za michango unayotafuta na jinsi mchakato unavyofanya kazi. Wachangiaji watahitaji kupitia mfululizo wa hatua ili waweze kuchangia kwenye hifadhi yako ya GitHub:

Kufork hifadhi yako Labda utataka watu kufork mradi wako. Kufork inamaanisha kuunda nakala ya hifadhi yako kwenye wasifu wao wa GitHub.
Clone. Kutoka hapo wataiga mradi kwenye kompyuta yao ya ndani.
Unda tawi. Utataka kuwaomba waunde tawi kwa kazi yao.
Kuzingatia mabadiliko yao kwenye eneo moja. Waombe wachangiaji kuzingatia michango yao kwenye kitu kimoja kwa wakati mmoja - kwa njia hiyo nafasi za kuweza kuunganisha kazi yao ni kubwa. Fikiria wanaandika marekebisho ya hitilafu, kuongeza kipengele kipya, na kusasisha majaribio kadhaa - vipi ikiwa unataka, au unaweza tu kutekeleza 2 kati ya 3, au 1 kati ya 3 mabadiliko?

✅ Fikiria hali ambapo matawi ni muhimu sana kwa kuandika na kusafirisha msimbo mzuri. Ni matumizi gani unayoweza kufikiria?

Kumbuka, kuwa mabadiliko unayotaka kuona duniani, na unda matawi kwa kazi yako mwenyewe pia. Uhifadhi wowote unaofanya utakuwa kwenye tawi ambalo umechagua "kuingia" kwa sasa. Tumia git status kuona ni tawi gani hilo.

Hebu tuendelee kupitia mtiririko wa mchango wa mchangiaji. Fikiria mchangiaji tayari ame fork na clone hifadhi hivyo ana hifadhi ya Git tayari kufanyiwa kazi, kwenye kompyuta yake ya ndani:

Unda tawi. Tumia amri git branch kuunda tawi ambalo litakuwa na mabadiliko wanayokusudia kuchangia:
```
git branch [branch-name]
```
💡 Njia ya Kisasa: Unaweza pia kuunda na kubadili tawi jipya kwa amri moja:
```
git switch -c [branch-name]
```
Badilisha kwenye tawi la kazi. Badilisha kwenye tawi lililobainishwa na usasishe saraka ya kazi kwa git switch:
```
git switch [branch-name]
```
💡 Kumbuka ya Kisasa: git switch ni mbadala wa kisasa wa git checkout wakati wa kubadilisha matawi. Ni wazi zaidi na salama kwa wanaoanza.
Fanya kazi. Kwa wakati huu unataka kuongeza mabadiliko yako. Usisahau kumwambia Git kuhusu hilo kwa amri zifuatazo:
```
git add .
git commit -m "my changes"
```
⚠️ Ubora wa Ujumbe wa Uhifadhi: Hakikisha unatoa uhifadhi wako jina zuri, kwa ajili yako na kwa msimamizi wa hifadhi unayesaidia. Kuwa maalum kuhusu kile ulichobadilisha!
Unganisha kazi yako na tawi la main. Wakati fulani unamaliza kazi na unataka kuunganisha kazi yako na ile ya tawi la main. Tawi la main linaweza kuwa limebadilika wakati huo kwa hivyo hakikisha unalisasisha kwanza na amri zifuatazo:
```
git switch main
git pull
```
Kwa wakati huu unataka kuhakikisha kwamba mizozo yoyote, hali ambapo Git haiwezi kuunganisha mabadiliko kwa urahisi inatokea kwenye tawi lako la kazi. Kwa hivyo endesha amri zifuatazo:
```
git switch [branch_name]
git merge main
```
Amri ya git merge main italeta mabadiliko yote kutoka main kwenye tawi lako. Tunatumaini unaweza tu kuendelea. Ikiwa sivyo, VS Code itakuonyesha wapi Git imechanganyikiwa na unarekebisha faili zilizoathiriwa ili kusema ni maudhui gani yaliyo sahihi zaidi.

💡 Njia mbadala ya kisasa: Fikiria kutumia git rebase kwa historia safi zaidi:
```
git rebase main
```
Hii inacheza tena uhifadhi wako juu ya tawi kuu la hivi karibuni, ikitengeneza historia ya mstari.
Tuma kazi yako kwenye GitHub. Kutuma kazi yako kwenye GitHub inamaanisha mambo mawili. Kusukuma tawi lako kwenye hifadhi yako na kisha kufungua PR, Ombi la Kuvuta.
```
git push --set-upstream origin [branch-name]
```
Amri hapo juu inaunda tawi kwenye hifadhi yako ya kufork.
Fungua PR. Kisha, unataka kufungua PR. Unafanya hivyo kwa kwenda kwenye hifadhi ya kufork kwenye GitHub. Utaona dalili kwenye GitHub ambapo inauliza ikiwa unataka kuunda PR mpya, unabonyeza hiyo na unapelekwa kwenye kiolesura ambapo unaweza kubadilisha kichwa cha ujumbe wa uhifadhi, kutoa maelezo yanayofaa zaidi. Sasa msimamizi wa hifadhi uliyofork ataona PR hii na vidole vimevukwa wataithamini na kuunganisha PR yako. Sasa wewe ni mchangiaji, hongera :)

💡 Kidokezo cha Kisasa: Unaweza pia kuunda PRs kwa kutumia GitHub CLI:
```
gh pr create --title "Your PR title" --body "Description of changes"
```
🔧 Mazoea bora kwa PRs:
- Unganisha masuala yanayohusiana kwa kutumia maneno kama "Fixes #123"
- Ongeza picha za skrini kwa mabadiliko ya UI
- Omba wakaguzi maalum
- Tumia PR za rasimu kwa kazi inayofanyika
- Hakikisha ukaguzi wote wa CI unakamilika kabla ya kuomba ukaguzi
Safisha. Inachukuliwa kuwa mazoea mazuri kusafisha baada ya kufanikiwa kuunganisha PR. Unataka kusafisha tawi lako la ndani na tawi ulilosukuma kwenye GitHub. Kwanza hebu tulifute kwa ndani kwa amri ifuatayo:
```
git branch -d [branch-name]
```
Hakikisha unakwenda kwenye ukurasa wa GitHub wa hifadhi ya kufork na kuondoa tawi la mbali ulilosukuma kwake.

Pull request inaonekana kama neno la kijinga kwa sababu kwa kweli unataka kusukuma mabadiliko yako kwenye mradi. Lakini msimamizi (mmiliki wa mradi) au timu kuu inahitaji kuzingatia mabadiliko yako kabla ya kuunganisha na tawi "kuu" la mradi, kwa hivyo kwa kweli unaomba uamuzi wa mabadiliko kutoka kwa msimamizi.

Ombi la kuvuta ni mahali pa kulinganisha na kujadili tofauti zilizoletwa kwenye tawi na ukaguzi, maoni, majaribio yaliyojumuishwa, na zaidi. Ombi zuri la kuvuta linafuata takriban sheria sawa na ujumbe wa uhifadhi. Unaweza kuongeza rejeleo kwa suala kwenye ufuatiliaji wa masuala, wakati kazi yako kwa mfano inarekebisha suala. Hii inafanywa kwa kutumia # ikifuatiwa na namba ya suala lako. Kwa mfano #97. 🤞Vidole vimevukwa kwamba ukaguzi wote utapita na mmiliki wa mradi ataunganisha mabadiliko yako kwenye mradi🤞

Sasisha tawi lako la kazi la ndani na mabadiliko yote mapya kutoka kwenye tawi la mbali linalolingana kwenye GitHub:

git pull

Kuchangia kwa Open Source (Fursa Yako ya Kuleta Mabadiliko!)

Je, uko tayari kwa kitu ambacho kitakushangaza kabisa? 🤯 Hebu tuzungumze kuhusu kuchangia kwenye miradi ya open source – na ninapata msisimko tu kufikiria kushiriki hili nawe!

Hii ni fursa yako ya kuwa sehemu ya kitu cha kipekee sana. Fikiria kuboresha zana ambazo mamilioni ya watengenezaji hutumia kila siku, au kurekebisha hitilafu kwenye programu ambayo marafiki zako wanapenda. Hiyo si ndoto tu – hiyo ndiyo maana ya kuchangia kwenye open source!

Hiki ndicho kinachonipa msisimko kila ninapofikiria: kila zana moja uliyojifunza nayo – mhariri wako wa msimbo, mifumo tutakayoichunguza, hata kivinjari unachosoma hiki ndani – ilianza na mtu kama wewe akifanya mchango wake wa kwanza. Yule mtengenezaji mahiri aliyeunda kiendelezi unachopenda cha VS Code? Wakati mmoja walikuwa mwanzilishi akibonyeza "create pull request" kwa mikono inayotetemeka, kama vile unavyotarajia kufanya.

Na hapa ndipo sehemu nzuri zaidi: jamii ya open source ni kama kukumbatiana kwa pamoja kwa mtandao. Miradi mingi hutafuta kwa bidii wanaoanza na ina masuala yaliyopewa alama "good first issue" mahsusi kwa watu kama wewe! Walezi wa miradi wanapendezwa sana wanapoona wachangiaji wapya kwa sababu wanakumbuka hatua zao za kwanza.

Hujifunzi tu kuandika msimbo hapa – unajiandaa kujiunga na familia ya kimataifa ya wajenzi wanaoamka kila siku wakifikiria "Tunawezaje kuboresha ulimwengu wa kidijitali kidogo zaidi?" Karibu kwenye klabu! 🌟

Kwanza, hebu tupate hifadhi (au repo) kwenye GitHub inayokuvutia na ambayo ungependa kuchangia mabadiliko. Utataka kunakili yaliyomo kwenye mashine yako.

✅ Njia nzuri ya kupata hifadhi zinazofaa kwa wanaoanza ni kutafuta kwa alama 'good-first-issue'.

Kuna njia kadhaa za kunakili msimbo. Njia moja ni "kuiga" yaliyomo ya hifadhi, kwa kutumia HTTPS, SSH, au kutumia GitHub CLI (Command Line Interface).

Fungua terminal yako na iga hifadhi kama hivi:

# Using HTTPS
git clone https://github.com/ProjectURL

# Using SSH (requires SSH key setup)
git clone git@github.com:username/repository.git

# Using GitHub CLI
gh repo clone username/repository

Ili kufanya kazi kwenye mradi, nenda kwenye folda sahihi: cd ProjectURL

Unaweza pia kufungua mradi mzima kwa kutumia:

GitHub Codespaces - Mazingira ya maendeleo ya wingu ya GitHub na VS Code kwenye kivinjari
GitHub Desktop - Programu ya GUI kwa operesheni za Git
GitHub.dev - Bonyeza kitufe cha . kwenye hifadhi yoyote ya GitHub kufungua VS Code kwenye kivinjari
VS Code na kiendelezi cha GitHub Pull Requests

Mwisho, unaweza kupakua msimbo kwenye folda iliyobanwa.

Mambo machache ya kuvutia kuhusu GitHub

Unaweza kuweka nyota, kutazama na/au "fork" hifadhi yoyote ya umma kwenye GitHub. Unaweza kupata hifadhi zako zilizowekewa nyota kwenye menyu ya kushuka ya juu-kulia. Ni kama kuweka alama ya kurasa, lakini kwa msimbo.

Miradi ina kifuatilia masuala, mara nyingi kwenye GitHub katika kichupo cha "Issues" isipokuwa imeonyeshwa vinginevyo, ambapo watu hujadili masuala yanayohusiana na mradi. Na kichupo cha Pull Requests ni mahali ambapo watu hujadili na kukagua mabadiliko yanayoendelea.

Miradi inaweza pia kuwa na majadiliano katika vikao, orodha za barua pepe, au njia za mazungumzo kama Slack, Discord au IRC.

🔧 Vipengele vya kisasa vya GitHub:

GitHub Discussions - Jukwaa la mazungumzo ya jamii lililojengwa ndani
GitHub Sponsors - Kusaidia walezi kifedha
Kichupo cha Usalama - Ripoti za udhaifu na ushauri wa usalama
Kichupo cha Actions - Tazama mtiririko wa kazi otomatiki na CI/CD
Kichupo cha Insights - Takwimu kuhusu wachangiaji, ahadi, na afya ya mradi
Kichupo cha Projects - Zana za usimamizi wa miradi zilizojengwa ndani ya GitHub

✅ Angalia hifadhi yako mpya ya GitHub na jaribu mambo kadhaa, kama kuhariri mipangilio, kuongeza taarifa kwenye hifadhi yako, kuunda mradi (kama bodi ya Kanban), na kuweka GitHub Actions kwa otomatiki. Kuna mengi unaweza kufanya!

🚀 Changamoto

Sawa, ni wakati wa kujaribu nguvu zako mpya za GitHub! 🚀 Hapa kuna changamoto itakayokufanya uelewe kila kitu kwa njia ya kuridhisha zaidi:

Chukua rafiki (au yule mwanafamilia ambaye kila mara huuliza unafanya nini na "vitu vyote vya kompyuta" hivi) na anza safari ya pamoja ya kuandika msimbo! Hapa ndipo uchawi halisi hutokea – unda mradi, wacha waifork, tengeneza matawi kadhaa, na unganisha mabadiliko kama wataalamu mnaokuwa.

Sitakuficha – labda mtacheka wakati fulani (hasa mnapojaribu kubadilisha mstari mmoja), labda mtashangaa kidogo, lakini hakika mtakuwa na nyakati za "aha!" za kushangaza zinazofanya kujifunza yote kuwa na thamani. Zaidi ya hayo, kuna kitu maalum kuhusu kushiriki muunganiko wa kwanza uliofanikiwa na mtu mwingine – ni kama sherehe ndogo ya jinsi mlivyofika mbali!

Huna rafiki wa kuandika msimbo bado? Usijali kabisa! Jamii ya GitHub imejaa watu wenye ukarimu sana wanaokumbuka jinsi ilivyokuwa kuwa mpya. Tafuta hifadhi zilizo na lebo za "good first issue" – kimsingi zinasema "Hey wanaoanza, njoo mjifunze nasi!" Hiyo ni ya kushangaza kiasi gani?

Jaribio la Baada ya Somo

Jaribio la baada ya somo

Mapitio & Endelea Kujifunza

Phew! 🎉 Tazama wewe – umeshinda misingi ya GitHub kama bingwa halisi! Ikiwa ubongo wako unahisi umejaa kidogo sasa, hiyo ni kawaida kabisa na kwa kweli ni ishara nzuri. Umejifunza zana ambazo zilinichukua wiki kujisikia vizuri nazo nilipoanza.

Git na GitHub ni zana zenye nguvu sana (kama, nguvu sana), na kila mtengenezaji ninayemjua – ikiwa ni pamoja na wale wanaoonekana kama wachawi sasa – walilazimika kufanya mazoezi na kujikwaa kidogo kabla ya kila kitu kuingia akilini. Ukweli kwamba umemaliza somo hili ina maana tayari uko njiani kuelekea kufahamu baadhi ya zana muhimu zaidi katika mkoba wa zana wa mtengenezaji.

Hapa kuna rasilimali za kushangaza kabisa zitakazokusaidia kufanya mazoezi na kuwa bora zaidi:

Mwongozo wa kuchangia kwa programu ya open source – Ramani yako ya kuleta mabadiliko
Karatasi ya mkato ya Git – Weka hii karibu kwa marejeleo ya haraka!

Na kumbuka: mazoezi huleta maendeleo, si ukamilifu! Kadri unavyotumia Git na GitHub, ndivyo inavyokuwa ya kawaida zaidi. GitHub imeunda kozi za maingiliano za kushangaza zinazokuruhusu kufanya mazoezi katika mazingira salama:

Unahisi kuwa na ujasiri? Angalia zana hizi za kisasa:

Nyaraka za GitHub CLI – Kwa wakati unataka kujisikia kama mchawi wa mstari wa amri
Nyaraka za GitHub Codespaces – Andika msimbo kwenye wingu!
Nyaraka za GitHub Actions – Otematiki kila kitu
Mazoea bora ya Git – Pandisha kiwango cha mtiririko wako wa kazi

Changamoto ya Wakala wa GitHub Copilot 🚀

Tumia hali ya Wakala kukamilisha changamoto ifuatayo:

Maelezo: Unda mradi wa maendeleo ya wavuti wa kushirikiana unaoonyesha mtiririko kamili wa GitHub uliyojifunza katika somo hili. Changamoto hii itakusaidia kufanya mazoezi ya uundaji wa hifadhi, vipengele vya ushirikiano, na mtiririko wa kazi wa Git wa kisasa katika hali halisi.

Kichocheo: Unda hifadhi mpya ya umma ya GitHub kwa mradi rahisi wa "Rasilimali za Maendeleo ya Wavuti". Hifadhi inapaswa kujumuisha faili ya README.md iliyopangwa vizuri inayoorodhesha zana na rasilimali muhimu za maendeleo ya wavuti, zilizopangwa kwa kategoria (HTML, CSS, JavaScript, nk). Weka hifadhi na viwango sahihi vya jamii ikiwa ni pamoja na leseni, miongozo ya kuchangia, na kanuni za maadili. Unda angalau matawi mawili ya vipengele: moja kwa kuongeza rasilimali za CSS na nyingine kwa rasilimali za JavaScript. Fanya ahadi kwa kila tawi na ujumbe wa ahadi unaoelezea, kisha unda maombi ya muunganiko ili kuunganisha mabadiliko kurudi kwenye tawi kuu. Washa vipengele vya GitHub kama Masuala, Majadiliano, na weka mtiririko wa kazi wa GitHub Actions wa ukaguzi wa otomatiki.

Kazi

Dhamira yako, ikiwa utaamua kuikubali: Kamilisha kozi ya Utangulizi wa GitHub kwenye Ujuzi wa GitHub. Kozi hii ya maingiliano itakuruhusu kufanya mazoezi ya kila kitu ulichojifunza katika mazingira salama, yanayoongozwa. Zaidi ya hayo, utapata beji nzuri unapomaliza! 🏅

Unahisi kuwa tayari kwa changamoto zaidi?

Weka uthibitisho wa SSH kwa akaunti yako ya GitHub (hakuna nywila tena!)
Jaribu kutumia GitHub CLI kwa operesheni zako za kila siku za Git
Unda hifadhi yenye mtiririko wa kazi wa GitHub Actions
Chunguza GitHub Codespaces kwa kufungua hifadhi hii katika mhariri wa wingu

Kumbuka: kila mtaalamu alikuwa mwanzilishi. Unaweza kufanya hili! 💪

Kanusho:
Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kwa usahihi, tafadhali fahamu kuwa tafsiri za kiotomatiki zinaweza kuwa na makosa au kutokuwa sahihi. Hati ya asili katika lugha yake ya awali inapaswa kuzingatiwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu ya binadamu inapendekezwa. Hatutawajibika kwa kutoelewana au tafsiri zisizo sahihi zinazotokana na matumizi ya tafsiri hii.

37 KiB Raw Blame History Unescape Escape