Bitcoin kwa Wajenzi Jenga na changia

Kuchangia programu huria za Bitsacco

Kutoka kupata tatizo hadi pendekezo la mabadiliko lililounganishwa: utaratibu, adabu na ukaguzi, ukifanya mazoezi kwenye hazina za Bitsacco zenyewe, ikiwemo hii.

60 dakikaKati7 / 8

Rasimu: somo hili bado linasubiri kukaguliwa.

Utakachojifunza

Tafuta tatizo linalofaa mwanzoni na uelewe sheria za mradi za kuchangia
Fanya badiliko dogo lenye lengo moja kwenye tawi na ufungue pendekezo la mabadiliko lililo wazi
Jibu ukaguzi wa msimbo na uhakikishe CI inapita

Maneno muhimu

programu huria (open source): Programu ambayo msimbo wake uko wazi kwa yeyote kusoma, kukagua na kuboresha.
pull request: Pendekezo la mabadiliko kwenye mradi wa GitHub, linalokaguliwa kabla ya kuunganishwa.

Miradi ya programu huria hukua kwa badiliko moja dogo na la uangalifu kwa wakati. Msimbo wa Bitsacco uko github.com/bitsacco: tovuti na programu ndogo kwa TypeScript (bitsacco/bitsacco), seva ya anwani za Lightning kwa Rust (bitsacco/lnaddrd); jukwaa hili la kujifunzia liko comwanga/bitsacco-jifunze. Kila badiliko huwafikia watumiaji tu kupitia pull request iliyokaguliwa na CI iliyopita.

Hatua ya 1: Tafuta kitu kinachofaa kufanywa

Soma README ya mradi na CONTRIBUTING.md kwanza. Zinakueleza jinsi ya kujenga, kujaribu na kupanga msimbo.
Tafuta matatizo yenye lebo good first issue au help wanted, au yale unayoweza kuyarudia mwenyewe.
Andika maoni kwenye tatizo kabla ya kuanza: "Ningependa kulifanyia kazi; huu ndio mpango wangu." Huzuia kazi kurudiwa.

Kwa Jifunze, michango mizuri ya kwanza ni kusahihisha herufi, kuboresha sentensi ya Kiswahili, kuongeza neno kwenye kamusi, au kutafsiri somo.

Umemaliza ukiweza: kuwa umechagua tatizo na mtunzaji anajua unalifanyia kazi.

Hatua ya 2: Fanya badiliko

gh repo fork comwanga/bitsacco-jifunze --clone
cd bitsacco-jifunze
git switch -c fix/wallets-keys-wording
npm ci
npm ci --prefix api # vitegemezi vya ukaguzi; haiwashi seva ya API
# hariri content/savers/sw/wallets-keys.mdx
npm run validate
npm run check
git commit -am "content(savers): clarify seed phrase backup wording in Kiswahili"
git push -u origin fix/wallets-keys-wording

Kila pendekezo liwe na wazo moja. Andika ujumbe wa commit ili mtu atakayesoma historia baada ya mwaka mmoja aelewe kwa nini.

Hatua ya 3: Fungua pendekezo lililo wazi

Maelezo mazuri hujibu maswali matatu:

Swali	Mfano
Nini kimebadilika?	Nimeandika upya hatua ya 2 ya orodha ya nakala ya akiba kwenye somo la Kiswahili.
Kwa nini?	"Usiyaandike mtandaoni" ilikuwa na utata; wasomaji walidhani inamaanisha mitandao ya kijamii tu.
Lilikaguliwaje?	`npm run validate` inapita; mkaguzi wa Kiswahili amesoma maneno mapya.

Unganisha tatizo kwa Closes #123. Ongeza picha za skrini kwa badiliko lolote linaloonekana.

Hatua ya 4: Ukaguzi na CI

CI ikishindwa, soma kumbukumbu zake, rekebisha, kisha sukuma tena; usiwaombe wakaguzi kuangalia ujenzi uliofeli.
Jibu kila maoni ya ukaguzi, hata kama ni "Nimefanya katika abc123". Usipokubaliana, eleza kwa nini kwa ushahidi na ubaki na adabu.
Kagua mapendekezo ya watu wengine pia. Kusoma msimbo ndiyo njia ya haraka zaidi ya kujifunza mradi.

Ushahidi wa maabara

Kiungo cha pendekezo lako la mabadiliko (kwa Jifunze, hazina nyingine ya Bitsacco, au nakala ya mazoezi).
Maelezo ya pendekezo lako, yakiwa na nini, kwa nini na jinsi lilivyokaguliwa.

Tafakari

Andika jibu lako, au jadili na rafiki au chama chako.

Nini kinachofanya pendekezo la mabadiliko liwe rahisi kukaguliwa na mtunzaji mwenye shughuli nyingi?
Ungejibuje maoni ya ukaguzi usiyokubaliana nayo?

Jipime

Soma zaidi

Bitsacco on GitHub (English)
Bitcoin Core contributing guide (English)

Somo asili la Bitsacco Jifunze. Leseni: CC BY-SA 4.0.