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

# Materion Cyntaf Da

Mae **Good First Issues** yn fenter i guradu detholiadau hawdd o brosiectau poblogaidd, fel y gall datblygwyr nad ydynt erioed wedi cyfrannu at ffynhonnell agored ddechrau'n gyflym.

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

Mae'r wefan hon wedi'i thargedu'n bennaf at ddatblygwyr sydd am gyfrannu at feddalwedd ffynhonnell agored ond nad ydynt yn gwybod ble na sut i ddechrau.

Mae cynhalwyr ffynhonnell agored bob amser yn ceisio cael mwy o bobl i gymryd rhan, ond yn gyffredinol mae datblygwyr newydd yn meddwl ei bod yn heriol dod yn gyfrannwr. Credwn fod cael datblygwyr i drwsio materion hynod hawdd yn cael gwared ar y rhwystr ar gyfer cyfraniadau yn y dyfodol. Dyma pam mae *Materion Cyntaf Da* yn bodoli.

## Ychwanegu prosiect newydd

Mae croeso i chi ychwanegu prosiect newydd yn *Materion Cyntaf Da*, dilynwch y camau hyn:

- Er mwyn cynnal ansawdd y prosiectau yn *Materion Cyntaf Da*, gwnewch yn siŵr bod eich storfa GitHub yn bodloni'r meini prawf canlynol:

     - Mae ganddo o leiaf dri mater gyda'r label `rhifyn cyntaf da`. Mae'r label hwn eisoes yn bresennol ar bob ystorfa yn ddiofyn.

     - Mae'n cynnwys `README.md` gyda chyfarwyddiadau gosod manwl ar gyfer y prosiect

     - Mae'n cael ei gynnal yn weithredol (diweddariad diwethaf lai nag 1 mis yn ôl)

- Ychwanegwch lwybr eich ystorfa (yn y fformat 'perchennog/enw' a threfn geiriadurol) yn [repositories.json]( https://github.com/gomzyakov/good-first-issue/blob/main/repositories.json).

- Creu cais tynnu newydd. Ychwanegwch y ddolen i dudalen materion y gadwrfa yn y disgrifiad PR. Unwaith y bydd y cais tynnu wedi'i uno, bydd y newidiadau yn fyw ar [good-first-issues.github.io]( https://good-first-issues.github.io).

## Sut mae'n gweithio?

- Yn gyntaf Mae *Good First Issues* yn wefan sefydlog sy'n defnyddio [PHP](https://www.php.net)` i gynhyrchu ffeiliau HTML.
- Rydym yn defnyddio [GitHub REST API] (https://docs.github.com/en/rest) i nôl materion o'r ystorfeydd a restrir yn [repositories.json]( https://github.com/gomzyakov/good-first -issue/blob/prif/storfeydd.json).
- I gylchredeg trwy faterion o bryd i'w gilydd (ddwywaith y dydd), rydym yn defnyddio [GitHub Workflow](https://docs.github.com/en/actions/using-workflows).

## Helpwch ni i dyfu

Gall llywio prosiectau ffynhonnell agored fod yn eithaf llethol i ddechreuwyr a chyfranwyr profiadol fel ei gilydd. Mae *Good First Issues* yn ceisio datrys y broblem hon trwy ddarparu platfform sy'n gweithredu fel man cychwyn i'r rhai sydd am ddechrau gyda ffynhonnell agored neu'r rhai sy'n edrych i ddechrau ar brosiect newydd.

Po fwyaf o bobl sy'n gwybod am [good-first-issues.github.io](https://good-first-issues.github.io), gorau oll. Mae yna nifer o ffyrdd y gallwch chi ein helpu i dyfu: gallech chi gyfrannu at restrau ‘anhygoel’, blogio amdanom ni, estyn allan i blogwyr, dylanwadau technoleg, datblygwr a ffynhonnell agored ar Twitter a YouTube, er enghraifft. Ceisiwch gael [good-first-issues.github.io](https://good-first-issues.github.io) wedi'i grybwyll mewn fideo neu drydariad!

## Awgrymiadau a dymuniadau

Os oes gennych chi gwestiynau neu awgrymiadau (neu os ydych chi wedi dod o hyd i nam), gallwch chi bob amser ysgrifennu at [materion]( https://github.com/good-first-issues/good-first-issues.github.io/issues).

## Trwydded

Meddalwedd ffynhonnell agored yw hon sydd wedi'i thrwyddedu o dan [Trwydded MIT]( https://github.com/good-first-issues/good-first-issues.github.io/blob/main/LICENSE).
