>**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/gomzykov/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/gomzykov/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), тем лучше. Вы можете помочь нам расти разными способами: вы можете внести свой вклад в «потрясающие» списки, вести блог о нас, связаться с блоггерами, влиятельными в сфере технологий, разработчиками и открытым исходным кодом, например, в Твиттере и 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).
