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

# Goeie eerste uitgawes

**Good First Issues** is 'n inisiatief om maklike keuses uit gewilde projekte saam te stel, sodat ontwikkelaars wat nog nooit tot oopbron bygedra het nie, vinnig kan begin.

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

Hierdie webwerf is hoofsaaklik gerig op ontwikkelaars wat wil bydra tot oopbronsagteware, maar nie weet waar of hoe om te begin nie.

Oopbron-onderhouers soek altyd om meer mense betrokke te kry, maar nuwe ontwikkelaars dink oor die algemeen dat dit uitdagend is om 'n bydraer te word. Ons glo om ontwikkelaars te kry om supermaklike kwessies op te los, verwyder die hindernis vir toekomstige bydraes. Dit is hoekom *Good First Issues* bestaan.

## Voeg 'n nuwe projek by

Jy is welkom om 'n nuwe projek in *Good First Issues* by te voeg, volg net hierdie stappe:

- Om die kwaliteit van projekte in *Good First Issues* te handhaaf, maak asseblief seker dat jou GitHub-bewaarplek aan die volgende kriteria voldoen:

     - Dit het ten minste drie uitgawes met die `goeie eerste uitgawe`-etiket. Hierdie etiket is reeds by verstek op alle bewaarplekke teenwoordig.

     - Dit bevat 'n `README.md` met gedetailleerde opstelinstruksies vir die projek

     - Dit word aktief onderhou (laaste opdatering minder as 1 maand gelede)

- Voeg jou bewaarplek se pad by (in die formaat `eienaar/naam` en leksikografiese volgorde) in [repositories.json](https://github.com/gomzyakov/good-first-issue/blob/main/repositories.json).

- Skep 'n nuwe trek-versoek. Voeg asseblief die skakel by die uitgawebladsy van die bewaarplek in die PR-beskrywing. Sodra die trekversoek saamgevoeg is, sal die veranderinge regstreeks wees op [good-first-issues.github.io](https://good-first-issues.github.io).

## Hoe werk dit?

- First *Good First Issues* is 'n statiese webwerf wat [PHP](https://www.php.net)` gebruik om HTML-lêers te genereer.
- Ons gebruik [GitHub REST API](https://docs.github.com/en/rest) om kwessies te gaan haal van die bewaarplekke wat in [repositories.json](https://github.com/gomzyakov/good-first) gelys is -issue/blob/main/repositories.json).
- Om periodiek deur kwessies te blaai (twee keer per dag), gebruik ons [GitHub Workflow](https://docs.github.com/en/actions/using-workflows).

## Help ons groei

Om oopbronprojekte te navigeer kan nogal oorweldigend wees vir beginners en ervare bydraers. *Goeie Eerste Kwessies* probeer hierdie probleem oplos deur 'n platform te verskaf wat dien as 'n beginpunt vir diegene wat wil begin met oopbron of diegene wat op soek is na 'n nuwe projek.

Hoe meer mense weet van [good-first-issues.github.io](https://good-first-issues.github.io), hoe beter. Daar is verskeie maniere waarop jy ons kan help om te groei: jy kan bydra tot `awesome` lyste, blog oor ons, uitreik na bloggers, tegnologie-invloede, ontwikkelaar en oopbron op Twitter en YouTube, byvoorbeeld. Probeer om [good-first-issues.github.io](https://good-first-issues.github.io) in 'n video of twiet genoem te kry!

## Voorstelle en wense

As jy vrae of voorstelle het (of 'n fout gevind het), kan jy altyd skryf aan [issues](https://github.com/good-first-issues/good-first-issues.github.io/issues).

## Lisensie

Dit is oopbronsagteware gelisensieer onder die [MIT-lisensie](https://github.com/good-first-issues/good-first-issues.github.io/blob/main/LICENSE).
