>**NOTE:** _This file has been translated automatically. If you find an error, just make a PR with the edits" to all translation files._
![Matoleo Mazuri ya Kwanza](../assets/github/social-preview.png)

# Masuala mazuri ya kwanza

**Matoleo Bora ya Kwanza** ni mpango wa kudhibiti chaguzi rahisi kutoka kwa miradi maarufu, ili wasanidi programu ambao hawajawahi kuchangia programu huria waweze kuanza haraka.

Tovuti: [good-first-issues.github.io](https://good-first-issues.github.io)

Tovuti hii inalenga wasanidi programu ambao wanataka kuchangia programu huria lakini hawajui wapi au jinsi ya kuanza.

Wasimamizi wa programu huria kila wakati wanatafuta kuhusisha watu zaidi, lakini wasanidi wapya kwa ujumla hufikiri ni changamoto kuwa mchangiaji. Tunaamini kuwa kupata wasanidi programu kurekebisha masuala ambayo ni rahisi sana huondoa kikwazo cha michango ya siku zijazo. Hii ndiyo sababu *Masuala Mema ya Kwanza* yapo.

## Inaongeza mradi mpya

Unakaribishwa kuongeza mradi mpya katika *Matoleo Bora ya Kwanza*, fuata tu hatua hizi:

- Ili kudumisha ubora wa miradi katika *Masuala Bora ya Kwanza*, tafadhali hakikisha hazina yako ya GitHub inatimiza vigezo vifuatavyo:

     - Ina angalau masuala matatu na lebo ya `bora la kwanza`. Lebo hii tayari iko kwenye hazina zote kwa chaguo-msingi.

     - Ina `README.md` iliyo na maagizo ya kina ya usanidi wa mradi

     - Inatunzwa kikamilifu (sasisho la mwisho chini ya mwezi 1 uliopita)

- Ongeza njia ya hazina yako (katika umbizo `mmiliki/jina` na mpangilio wa kamusi) katika [repositories.json](https://github.com/gomzyakov/good-first-issue/blob/main/repositories.json).

- Unda ombi jipya la kuvuta. Tafadhali ongeza kiungo kwenye ukurasa wa masuala ya hazina katika maelezo ya PR. Mara tu ombi la kuvuta linapounganishwa, mabadiliko yatakuwa moja kwa moja kwenye [good-first-issues.github.io](https://good-first-issues.github.io).

## Inafanyaje kazi?

- *Matoleo Mazuri ya Kwanza* ya Kwanza ni tovuti tuli inayotumia [PHP](https://www.php.net)` kutengeneza faili za HTML.
- Tunatumia [GitHub REST API](https://docs.github.com/en/rest) kuleta masuala kutoka kwa hazina zilizoorodheshwa katika [repositories.json](https://github.com/gomzyakov/good-first -toleo/blob/main/repositories.json).
- Ili kuzunguka matatizo mara kwa mara (mara mbili kwa siku), tunatumia [GitHub Workflow](https://docs.github.com/en/actions/using-workflows).

## Tusaidie kukua

Kusogeza kwenye miradi ya programu huria kunaweza kuwa mzito sana kwa wanaoanza na wachangiaji wenye uzoefu sawa. *Masuala Mema ya Kwanza* inaonekana kusuluhisha tatizo hili kwa kutoa jukwaa ambalo hutumika kama mahali pa kuanzia kwa wale wanaotaka kuanza kutumia programu huria au wale wanaotafuta kuingia katika mradi mpya.

Kadiri watu wanavyojua zaidi kuhusu [good-first-issues.github.io](https://good-first-issues.github.io), ndivyo wanavyoboreka. Kuna njia mbalimbali unazoweza kutusaidia kukua: unaweza kuchangia kwenye orodha `za kustaajabisha`, blogu kutuhusu, kufikia wanablogu, ushawishi wa teknolojia, msanidi programu na chanzo huria kwenye Twitter na YouTube, kwa mfano. Jaribu na upate [good-first-issues.github.io](https://good-first-issues.github.io) iliyotajwa kwenye video au tweet!

## Mapendekezo na matakwa

Ikiwa una maswali au mapendekezo (au umepata hitilafu), unaweza kuandika kwa [issues](https://github.com/good-first-issues/good-first-issues.github.io/issues).

# #Leseni

Hii ni programu huria iliyoidhinishwa chini ya [Leseni ya MIT](https://github.com/good-first-issues/good-first-issues.github.io/blob/main/LICENSE).
