>**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 Workflow](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).
