Skip to content

Latest commit

 

History

History
48 lines (26 loc) · 5.15 KB

File metadata and controls

48 lines (26 loc) · 5.15 KB

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 ابتکاری برای انتخاب آسان از پروژه های محبوب است، بنابراین توسعه دهندگانی که هرگز به منبع باز کمک نکرده اند، می توانند به سرعت شروع به کار کنند.

وب سایت: 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` برای تولید فایل های HTML استفاده می کند.
  • ما از GitHub REST API برای واکشی مشکلات از مخازن فهرست شده در repositories.json استفاده می کنیم -issue/blob/main/repositories.json).
  • برای چرخه دوره ای مشکلات (دو بار در روز)، از [GitHub Workflow] (https://docs.github.com/en/actions/using-workflows) استفاده می کنیم.

به ما کمک کنید رشد کنیم

پیمایش پروژه‌های متن‌باز می‌تواند برای مبتدیان و مشارکت‌کنندگان باتجربه بسیار سخت باشد. Good First Issues به نظر می رسد این مشکل را با ارائه پلتفرمی حل کند که به عنوان نقطه شروعی برای کسانی که به دنبال شروع کار با منبع باز هستند یا کسانی که به دنبال ورود به یک پروژه جدید هستند عمل می کند.

هرچه افراد بیشتری درباره good-first-issues.github.io اطلاعات بیشتری داشته باشند، بهتر است. راه‌های مختلفی وجود دارد که می‌توانید به رشد ما کمک کنید: به عنوان مثال، می‌توانید در فهرست‌های «عالی‌کننده»، وبلاگ‌نویسی درباره ما، دسترسی به وبلاگ‌نویسان، تأثیرگذاران فناوری، توسعه‌دهندگان و منبع باز در توییتر و یوتیوب مشارکت کنید. سعی کنید 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) است.