این جشن کد نویسی راهی عالی برای درگیر شدن با اولین مشارکت منبع باز شماست.
Hacktoberfest جشن سالانه یک ماهه پروژه های منبع باز، نگهبانان و مشارکت کنندگان است. هدف این رویداد ترویج منبع باز و تشویق توسعه دهندگان به مشارکت است.
Hacktoberfest با مشوق هایی برای 40000 شرکت کننده اول ارائه می شود که تا 31 اکتبر چهار درخواست جذب دریافت می کنند. شما می توانید یک درخت به نام خود کاشته شده یا یک تی شرت Hacktoberfest دریافت کنید.
همه چیز با اولین درخواست کشش/ادغام شما شروع می شود.
ثبت نام در Hacktoberfest
برای شرکت در Hacktoberfest، ابتدا باید برای رویداد در hacktoberfest.com ثبت نام کنید.
صفحه ای شبیه به این را خواهید دید:
برای مشارکت باید یک حساب GitHub یا GitLab داشته باشید.
سرویس میزبانی مورد نظر خود را انتخاب کنید و روی دکمه INITIATE کلیک کنید. با کلیک بر روی این دکمه شما را به برنامه انتخابی خود هدایت می کنید، که از شما می خواهد Hacktoberfest را تأیید کنید.
مجوز Hacktoberfest به طور خودکار شما را برای رویداد ثبت می کند.
یافتن پروژه هایی برای مشارکت در GitHub و GitLab
فقط مشارکت در پروژه های متن باز شرکت در GitHub یا GitLab برای Hacktoberfest محاسبه می شود. برای مشارکت باید یک حساب GitHub یا GitLab داشته باشید.
GitHub
برای یافتن پروژه های شرکت کننده در Hacktoberfest در GitHub:
- به github.com بروید.
- به نوار جستجو در GitHub بروید یا کلید اسلش (/) را روی صفحه کلید خود فشار دهید.
- “Hacktoberfest” را تایپ کنید و روی دکمه ENTER کلیک کنید.
با دنبال کردن مراحل بالا چندین نتیجه نمایش داده می شود که موضوع Hacktoberfest در بالای صفحه قرار دارد. همانطور که در تصویر زیر نشان داده شده است، این موضوع فهرستی از مخازن را که می توانید در آنها مشارکت داشته باشید به شما ارائه می دهد.
از طرف دیگر، می توانید مستقیماً به موضوع هکتوبرفست GitHub بروید.
GitLab
برای یافتن پروژه های شرکت کننده در Hacktoberfest در GitLab:
- به gitlab.com بروید.
- در صفحه اصلی، کاوش پروژه های عمومی را انتخاب کنید.
- در صفحه کاوش پروژه ها، کاوش موضوعات را انتخاب کنید.
- در قسمت فیلتر بر اساس جستجو، “Hacktoberfest” را وارد کنید.
با دنبال کردن مراحل بالا چندین نتیجه نمایش داده می‌شود که موضوع Hacktoberfest اولین آن است. همانطور که در تصویر زیر نشان داده شده است، این موضوع فهرستی از مخازن را که می توانید در آنها مشارکت داشته باشید به شما ارائه می دهد.
از طرف دیگر، می توانید مستقیماً به موضوع GitLab Hacktoberfest بروید.
ایجاد یک درخواست کششی (PR) در GitHub
درخواست کشش (PR) پیشنهادی است که توسط یک مشارکت‌کننده به پروژه ارائه می‌شود و از نگهدارنده پروژه می‌خواهد تغییرات پیشنهادی را در پروژه بررسی و ادغام کند.
برای ایجاد روابط عمومی، باید یک پروژه Hacktoberfest را پیدا کنید که می خواهید در آن مشارکت داشته باشید. هنگامی که پروژه ای را پیدا کردید، روی دکمه فورک در گوشه سمت راست بالا کلیک کنید:
فورک کردن یک پروژه یک کپی از پروژه را در حساب GitHub شما ایجاد می کند و به شما این امکان را می دهد که تغییراتی را بدون تأثیر بر پروژه اصلی ایجاد کنید. پس از فورک پروژه، مخزن را از حساب خود کلون کنید و تغییرات را در محیط توسعه محلی خود ایجاد کنید.
حتما دستورالعمل های مشارکت پروژه را بخوانید و از آنها پیروی کنید تا شانس درخواست کشش خود را افزایش دهید.
پس از ایجاد تغییرات و افزودن نسخه فورک شده مخزن، تغییرات را با استفاده از Git انجام دهید و آنها را به GitHub فشار دهید.
هنگامی که تغییرات در GitHub منعکس می شود، همانطور که در تصویر زیر نشان داده شده است، پیامی دریافت خواهید کرد که به شما اطلاع می دهد که فورک شما جلوتر از شاخه اصلی “متعهد” شده است.
بعد، روی دکمه مشارکت در اعلان کلیک کنید. با کلیک بر روی این دکمه، مانند تصویر زیر، درخواست کشش را باز کنید.
سپس بر روی دکمه باز کردن درخواست کشش کلیک کنید. این شما را به صفحه‌ای هدایت می‌کند که در آن دستورالعمل‌های مشارکت و عنوان و توضیحات درخواست کشش خود را بررسی می‌کنید.
فیلدهای مورد نیاز را پر کنید و مانند تصویر زیر بر روی دکمه Create pull request کلیک کنید.
شما یک درخواست کشش ایجاد کرده اید. اکنون منتظر بمانید تا نگهبانان پروژه مشارکت شما را بررسی و ادغام یا رد کنند.
ایجاد یک درخواست ادغام در GitLab
درخواست ادغام با درخواست کشش یکسان است. تنها تفاوت در نام آنهاست.
برای درخواست ادغام، ابتدا باید یک پروژه Hacktoberfest را پیدا کنید که می خواهید در آن مشارکت کنید. هنگامی که پروژه ای را پیدا کردید، روی دکمه فورک در گوشه سمت راست بالا کلیک کنید:
فورک کردن یک پروژه یک کپی از پروژه را در حساب GitLab شما ایجاد می کند و به شما این امکان را می دهد که تغییراتی را بدون تأثیر بر پروژه اصلی ایجاد کنید. پس از فورک پروژه، مخزن را از حساب خود کلون کنید و تغییرات را در محیط توسعه محلی خود ایجاد کنید.
حتما دستورالعمل های مشارکت پروژه را بخوانید و از آنها پیروی کنید تا شانس درخواست کشش خود را افزایش دهید.
پس از ایجاد تغییرات و افزودن نسخه فورک شده مخزن، تغییرات را انجام دهید و آنها را به GitLab فشار دهید.
بعد از اینکه تغییرات خود را در GitLab اعمال کردید، به پروژه فورک شده خود بروید و روی Merge requests در نوار کناری کلیک کنید. با این کار صفحه ای نمایش داده می شود که یک درخواست ادغام و یک دکمه درخواست ادغام جدید را توضیح می دهد. همانطور که در تصویر زیر نشان داده شده است، روی دکمه New merge request کلیک کنید.
در مرحله بعد، باید یک شاخه منبع و هدف را انتخاب کنید. شاخه منبع باید شاخه ای باشد که تغییراتی که می خواهید در مخزن اصلی انجام دهید در آن قرار دارد. شاخه هدف باید مخزن اصلی باشد که می خواهید تغییرات خود را در آن انجام دهید. پس از انتخاب شاخه ها مانند تصویر زیر بر روی دکمه مقایسه شاخه ها و ادامه کلیک کنید.
با کلیک بر روی دکمه مقایسه شاخه‌ها و ادامه به صفحه‌ای می‌روید که می‌توانید عنوان و توضیحاتی را برای درخواست ادغام خود وارد کنید.
همانطور که در تصویر زیر نشان داده شده است، جزئیات مورد نیاز را پر کنید و روی دکمه ایجاد درخواست ادغام کلیک کنید.
با کلیک بر روی این دکمه درخواست ادغام شما ایجاد می شود. حال باید منتظر بمانید تا نگهبانان پروژه درخواست pull شما را بررسی و ادغام یا ببندند.
شرایط و ضوابط Hacktoberfest
تمام مشارکت های انجام شده در پروژه های Hacktoberfest باید در محدوده Hacktoberfest باشد و هرزنامه نباشد. عدم رعایت قوانین Hacktoberfest می تواند باعث محرومیت از رویداد شود.
Hacktoberfest یک دوره بررسی هفت روزه برای درخواست‌های کشش/ادغام که از تمام دستورالعمل‌ها پیروی می‌کنند، صادر می‌کند. اگر روابط عمومی شما خوب است، پروژه باید آن را برای Hacktoberfest در آن بازه زمانی بپذیرد.
مشارکت مبارک!