>**NOTE:** _This file has been translated automatically. If you find an error, just make a PR with the edits" to all translation files._
![Добрыя першыя выпускі](../assets/github/social-preview.png)

# Добрыя першыя выпускі

**Good First Issues** - гэта ініцыятыва, каб лёгка выбраць папулярныя праекты, каб распрацоўшчыкі, якія ніколі не ўдзельнічалі ў адкрытым зыходным коды, маглі хутка пачаць працу.

Вэб-сайт: [good-first-issues.github.io](https://good-first-issues.github.io)

Гэты вэб-сайт у першую чаргу арыентаваны на распрацоўшчыкаў, якія жадаюць унесці свой уклад у праграмнае забеспячэнне з адкрытым зыходным кодам, але не ведаюць, з чаго і як пачаць.

Супрацоўнікі праграм з адкрытым зыходным кодам заўсёды імкнуцца прыцягнуць больш людзей, але новыя распрацоўшчыкі звычайна лічаць, што стаць удзельнікам складана. Мы лічым, што прымус распрацоўшчыкаў выправіць вельмі простыя праблемы ліквідуе бар'ер для будучых укладаў. Вось чаму *Good First Issues* існуе.

## Даданне новага праекта

Вы можаце дадаць новы праект у *Good First Issues*, проста выканайце наступныя дзеянні:

- Каб падтрымліваць якасць праектаў у *Good First Issues*, пераканайцеся, што ваш рэпазітар GitHub адпавядае наступным крытэрыям:

     - У яго як мінімум тры выпускі з пазнакай "добры першы выпуск". Гэтая пазнака ўжо прысутнічае ва ўсіх сховішчах па змаўчанні.

     - Ён змяшчае `README.md` з падрабязнымі інструкцыямі па наладцы для праекта

     - Ён актыўна падтрымліваецца (апошняе абнаўленне менш за 1 месяц таму)

- Дадайце шлях да сховішча (у фармаце `уладальнік/імя` і лексікаграфічным парадку) у [repositories.json](https://github.com/gomzyakov/good-first-issue/blob/main/repositories.json).

- Стварыце новы запыт на выцягванне. Калі ласка, дадайце спасылку на старонку пытанняў рэпазітара ў апісанне PR. Пасля аб'яднання запыту на выцягванне змены будуць даступныя на [good-first-issues.github.io](https://good-first-issues.github.io).

## Як гэта працуе?

- First *Good First Issues* - гэта статычны вэб-сайт, які выкарыстоўвае [PHP](https://www.php.net)` для стварэння файлаў HTML.
- Мы выкарыстоўваем [GitHub REST API](https://docs.github.com/en/rest) для атрымання праблем з рэпазітараў, пералічаных у [repositories.json](https://github.com/gomzyakov/good-first) -issue/blob/main/repositories.json).
- Каб перыядычна праглядаць праблемы (два разы на дзень), мы выкарыстоўваем [Рабочы працэс GitHub](https://docs.github.com/en/actions/using-workflows).

## Дапамажыце нам расці

Навігацыя па праектах з адкрытым зыходным кодам можа быць даволі цяжкай для пачаткоўцаў і вопытных удзельнікаў. *Good First Issues* імкнецца вырашыць гэтую праблему, забяспечваючы платформу, якая служыць адпраўной кропкай для тых, хто хоча пачаць працу з адкрытым зыходным кодам, або тых, хто хоча ўвайсці ў новы праект.

Чым больш людзей ведаюць пра [good-first-issues.github.io](https://good-first-issues.github.io), тым лепш. Ёсць розныя спосабы, якімі вы можаце дапамагчы нам расці: вы можаце ўнесці свой уклад у `выдатныя` спісы, весці пра нас блогі, звяртацца да блогераў, тэхнічных уплывоў, распрацоўшчыкаў і адкрытых зыходных кодаў у Twitter і YouTube, напрыклад. Паспрабуйце згадаць [good-first-issues.github.io](https://good-first-issues.github.io) у відэа ці твітэры!

## Прапановы і пажаданні

Калі ў вас ёсць пытанні ці прапановы (або вы знайшлі памылку), вы заўсёды можаце напісаць на адрас [issues](https://github.com/good-first-issues/good-first-issues.github.io/issues).

## Ліцэнзія

Гэта праграмнае забеспячэнне з адкрытым зыходным кодам, ліцэнзаванае ў адпаведнасці з [ліцэнзіяй MIT](https://github.com/good-first-issues/good-first-issues.github.io/blob/main/LICENSE).
