>**NOTE:** _This file has been translated automatically. If you find an error, just make a PR with the edits" to all translation files._
![Good First Issues](../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*, проверете дали вашето складиште на GitHub ги исполнува следниве критериуми:

     - Има најмалку три изданија со етикетата „добар прв број“. Оваа ознака стандардно е веќе присутна на сите складишта.

     - Содржи `README.md` со детални упатства за поставување на проектот

     - Активно се одржува (последно ажурирање пред помалку од 1 месец)

- Додајте ја патеката на вашето складиште (во форматот „сопственик/име“ и лексикографски редослед) во [repositories.json](https://github.com/gomzyakov/good-first-issue/blob/main/repositories.json).

- Креирајте ново барање за повлекување. Ве молиме додајте ја врската до страницата со проблеми на складиштето во описот за односи со јавноста. Откако ќе се спои барањето за повлекување, промените ќе бидат во живо на [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).
