آواتار آپلودشده‌ی iHiD

رهنمودهای تازه‌ی مشارکت

@iHiD
حدود 3 سال پیش

اگر از یک Issue/PR که به‌طور خودکار بسته شده به اینجا هدایت شده‌اید، لطفاً نه نگران شوید و نه احساس کنید که کارتان رد شده است. در بیشتر موارد، هر کاری که انجام داده‌اید سرانجام در Exercism ادغام می‌شود یا مشکل‌تان حل خواهد شد. ما از مشارکت‌ها استقبال می‌کنیم و آن‌ها را تشویق می‌کنیم، اما دوست داریم پیش از رفتن سراغ کد در GitHub، موضوع را در انجمن‌مان بحث کنیم. باز کردن یک موضوع در انجمن کار را جلو می‌برد.


در یک سال گذشته، ما در حال آزمایش محدود کردن مشارکت‌های افراد غیرنگهدارنده بوده‌ایم تا وقت مشارکت‌کنندگان اصلی‌مان آزاد شود و بتوانند بهبودهای چشمگیرتری در مسیرها ایجاد کنند. این کار خیلی خوب جواب داده است. در مقایسه با ۲۰۲۲، در طول ۲۰۲۳ شاهد دو برابر شدن تعداد تمرین‌های تازه‌ای که اضافه شده‌اند و سه برابر شدن تعداد برنامه‌های درسی‌ای که ساخته شده‌اند بوده‌ایم. تغییر روش کار، مشارکت‌های بسیار بزرگ‌تر و ناامیدی و حواس‌پرتی کمتر برای مشارکت‌کنندگان اصلی‌مان را ممکن کرده است.

با این حال، آگاهم که این کار برای مشارکت‌کنندگان تازه‌ای که مصمم به کمک هستند اما احساس می‌کنند فرایند مشارکت ما جلویشان را گرفته، ناامیدی ایجاد کرده است. بنابراین امروز می‌خواهم چند راهنمای تازه (یا شفاف‌شده) درباره‌ی اینکه در چند ماه آینده چگونه با مشارکت‌ها پیش خواهیم رفت، مطرح کنم.

قاعده‌ی بنیادینی که باید درکش کنید این است که ما ایده‌ها، باگ‌ها و Issueها را در انجمن‌مان بحث می‌کنیم و تغییرات حاصل در کد را در GitHub (در بازبینی‌های PR) به بحث می‌گذاریم. قاعده‌ی دوم این است که (به‌جز نگهدارندگانی که خودمختارند) پیش از انجام کارها درباره‌شان بحث می‌کنیم. انجمن ما به مشارکت‌کنندگان و نگهدارندگان در همه‌ی مسیرها امکان می‌دهد دانش و تجربه‌شان را درباره‌ی طیف گسترده‌ای از زبان‌ها و ایده‌ها به اشتراک بگذارند، بدون اینکه لازم باشد در ۳۰۰ مخزن مختلف در GitHub مشترک شوند و اعلان‌هایشان را زیر بار سنگین ببرند.

راهنمای به‌روزشده

دریافت پشتیبانی

  • اگر پیش از حل یک تمرین جایی گیر کرده‌اید (مثلاً نصب CLI، اجرای تست‌ها، یا گیر کردن روی منطق/الزامات یک تمرین)، راه‌های پشتیبانی ما دسته‌ی «Exercism Support» در انجمن و کانال #get-help در سرور Discord ما هستند.
  • ما برای درخواست‌های پشتیبانی از GitHub یا ایمیل استفاده نمی‌کنیم.
  • اگر تمرینی را حل کرده‌اید اما درباره‌اش پرسشی دارید، باید درخواست منتورینگ را در خود Exercism ثبت کنید.

گزارش باگ/Issue

  • همه‌ی باگ‌ها/Issueها باید در انجمن ما باز شوند، جایی که افراد زیادی می‌توانند به درک و حل مشکل کمک کنند.
    • اگر Issue مربوط به یک زبان است، لطفاً از دسته‌ی مربوط به Programming/xxx استفاده کنید.
    • اگر باگی در وب‌سایت است، لطفاً از دسته‌ی «Bugs & Feature Requests» استفاده کنید.
  • Issueهای GitHub عموماً به‌طور خودکار بسته می‌شوند و کسی که آن‌ها را ثبت کرده به انجمن هدایت می‌شود (با یک لینک یک‌کلیکی برای کپی/پیست کردن Issueاش، همان‌طور که اکنون هست).
  • نگهدارندگان مسیرها می‌توانند بستن خودکار Issueها را خاموش کنند، اما مسیر رسمی همچنان انجمن است.

باز کردن Pull Requestها

  • پیش از انجام کار، باید درباره‌ی Pull Requestها در انجمن بحث شود.
  • Pull Requestهای افرادی که عضو سازمان نیستند همچنان به‌طور خودکار بسته می‌شوند، اما اغلب پس از بحث درباره‌ی کار در انجمن دوباره باز می‌شوند. اگر ایده‌ی پشت یک PR پیش‌تر تأیید شده است، فقط لینک آن PR را در موضوع مربوط در انجمن بگذارید و ما آن را دوباره باز می‌کنیم.
  • نگهدارندگان مسیرها می‌توانند بستن خودکار PRها را خاموش کنند، اما همچنان توصیه می‌کنیم درباره‌ی همه‌ی PRها نخست از طریق انجمن بحث شود.

خلاصه

اولویت نخست ما همچنان حفظ زمان و توان ذهنی مشارکت‌کنندگان اصلی‌مان است؛ همان‌هایی که بدون آن‌ها Exercism نمی‌تواند به کار خود ادامه دهد. اما می‌خواهیم مطمئن شویم Exercism جایی می‌ماند که افراد تازه می‌توانند بدون موانع بیش از حد بازدارنده وارد شوند و جایی که می‌توانیم آن‌ها را تشویق و حمایت کنیم تا خودشان به مشارکت‌کنندگان اصلی تبدیل شوند!

بی‌صبرانه منتظرم ببینم این تغییرات در چند ماه آینده چه تأثیری بر مشارکت‌هایی که می‌بینیم می‌گذارد. اواسط ۲۰۲۴ دوباره همه چیز را بازبینی می‌کنیم.

2 نوامبر 2023 · برایتان مفید بود؟