>**NOTE:** _This file has been translated automatically. If you find an error, just make a PR with the edits" to all translation files._
![İlk Məsələlər Yaxşı](../assets/github/social-preview.png)

# Yaxşı İlk Məsələlər

**Good First Issues** populyar layihələrdən asan seçimlər üçün təşəbbüsdür, ona görə də heç vaxt açıq mənbəyə töhfə verməyən tərtibatçılar tez işə başlaya bilərlər.

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

Bu veb sayt ilk növbədə açıq mənbə proqram təminatına töhfə vermək istəyən, lakin haradan və necə başlayacağını bilməyən tərtibatçılar üçün nəzərdə tutulub.

Açıq mənbə sahibləri həmişə daha çox insanı cəlb etməyə çalışırlar, lakin yeni tərtibatçılar ümumiyyətlə töhfəçi olmağın çətin olduğunu düşünürlər. İnanırıq ki, tərtibatçıların çox asan problemləri həll etməsi gələcək töhfələr üçün maneəni aradan qaldıracaq. Bu səbəbdən *Good First Issues* mövcuddur.

## Yeni layihə əlavə edilir

Siz *Good First Issues* bölməsinə yeni layihə əlavə edə bilərsiniz, sadəcə olaraq bu addımları yerinə yetirin:

- *Good First Issues* proqramında layihələrin keyfiyyətini qorumaq üçün GitHub repozitorunuzun aşağıdakı meyarlara cavab verdiyinə əmin olun:

     - "Yaxşı ilk buraxılış" etiketi ilə ən azı üç problemi var. Bu etiket artıq defolt olaraq bütün depolarda mövcuddur.

     - Bu layihə üçün ətraflı quraşdırma təlimatları ilə 'README.md' ehtiva edir

     - Aktiv şəkildə saxlanılır (son yeniləmə 1 aydan az əvvəl)

- [repositories.json](https://github.com/gomzyakov/good-first-issue/blob/main/repositories.json) bölməsinə repozitorunuzun yolunu (`sahib/ad` formatında və leksikoqrafik qaydada) əlavə edin.

- Yeni çəkmə sorğusu yaradın. Lütfən, PR təsvirində repozitoriyanın məsələlər səhifəsinə keçid əlavə edin. Çəkmə sorğusu birləşdirildikdən sonra dəyişikliklər [good-first-issues.github.io](https://good-first-issues.github.io) saytında canlı olacaq.

## Bu necə işləyir?

- First *Good First Issues* HTML faylları yaratmaq üçün [PHP](https://www.php.net)` istifadə edən statik vebsaytdır.
- Biz [repositories.json](https://github.com/gomzyakov/good-first) siyahısında sadalanan repozitoriyalardan problemləri əldə etmək üçün [GitHub REST API](https://docs.github.com/en/rest) istifadə edirik. -issue/blob/main/repositories.json).
- Problemləri vaxtaşırı dövrə vurmaq üçün (gündə iki dəfə) biz [GitHub Workflow](https://docs.github.com/en/actions/using-workflows) istifadə edirik.

## Bizə böyüməyə kömək edin

Açıq mənbəli layihələrdə naviqasiya həm yeni başlayanlar, həm də təcrübəli iştirakçılar üçün olduqca çətin ola bilər. *Good First Issues* bu problemi açıq mənbəyə başlamaq istəyənlər və ya yeni layihəyə daxil olmaq istəyənlər üçün başlanğıc nöqtəsi kimi xidmət edən platforma təmin etməklə həll etməyə çalışır.

[good-first-issues.github.io](https://good-first-issues.github.io) haqqında nə qədər çox insan bilirsə, bir o qədər yaxşıdır. Böyüməyimizə kömək edə biləcəyiniz müxtəlif yollar var: məsələn, “möhtəşəm” siyahılara töhfə verə, haqqımızda blog yaza, bloggerlərə, texnoloji təsirlərə, tərtibatçıya və Twitter və YouTube-da açıq mənbəyə müraciət edə bilərsiniz. Video və ya tvitdə qeyd olunan [good-first-issues.github.io](https://good-first-issues.github.io) əldə etməyə çalışın!

## Təklif və arzular

Suallarınız və ya təklifləriniz varsa (və ya səhv tapsanız), həmişə [issues] ünvanına yaza bilərsiniz (https://github.com/good-first-issues/good-first-issues.github.io/issues).

## Lisenziya

Bu, [MIT License] (https://github.com/good-first-issues/good-first-issues.github.io/blob/main/LICENSE) əsasında lisenziyalaşdırılmış açıq mənbəli proqram təminatıdır.
