>**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*، لطفاً مطمئن شوید که مخزن 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) اطلاعات بیشتری داشته باشند، بهتر است. راه‌های مختلفی وجود دارد که می‌توانید به رشد ما کمک کنید: به عنوان مثال، می‌توانید در فهرست‌های «عالی‌کننده»، وبلاگ‌نویسی درباره ما، دسترسی به وبلاگ‌نویسان، تأثیرگذاران فناوری، توسعه‌دهندگان و منبع باز در توییتر و یوتیوب مشارکت کنید. سعی کنید [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) است.
