Summarize this content to 400 words in Persian Lang
به 6 چیزی که درباره Hacktoberfest (زمانی که در حال یادگیری کدنویسی هستید) به شما نمی گویند خوش آمدید. در این مجموعه، نکاتی را برای کدنویسان خودآموخته به اشتراک می گذاریم که منابع رسمی Hacktoberfest ممکن است آنها را پوشش ندهند.
لطفاً توجه داشته باشید که در حالی که مشارکت‌کنندگان می‌توانند از GitHub یا GitLab برای شرکت در Hacktoberfest استفاده کنند، ما در این مقاله فقط درباره GitHub صحبت خواهیم کرد.
در حین مرور مخازن Hacktoberfest، متوجه شدم که برخی از نگهبانان درخواست کرده اند که مشارکت کنندگان از آنها نخواهند که مسائل را تعیین کنند. (یعنی “اگر می خواهید روی مشکلی کار کنید، فقط آن را انجام دهید و سپس یک درخواست کشش برای من ارسال کنید.”)
این باعث شد که من تعجب کنم: اگر مشکلی تعیین نشده باشد، چه کسی اعتبار را دریافت می کند اگر چندین نفر درخواست کنند که آن را برطرف کند؟ اگر هر یک از آنها پاسخی متفاوت و در عین حال متضاد به یک مشکل ارائه دهند، آیا اولین مشارکتی که ارائه شده است ادغام می شود یا راه حلی است که نگهدارنده بیشتر دوست دارد؟
علاوه بر این، آیا تنها درخواست کششی که ادغام می شود، حساب می شود؟ به عبارت دیگر، آیا ممکن است بیش از یک مشارکت کننده برای کار بر روی یک موضوع اعتبار دریافت کنند یا اینکه ما به عنوان مشارکت کننده باید برای دریافت دیب با یکدیگر رقابت کنیم؟
پاسخ به تمام سوالات فوق این است: بستگی دارد. برای درک دلیل، اجازه دهید راه های متعددی را که نگهبانان می توانند درخواست های کشش را تأیید کنند، بررسی کنیم.
ادغام یک درخواست کشش در یک مخزن با موضوع “هکتوبرفست”.
موضوع “هکتوبرفست” خودکارترین وسیله ای است که با آن مشارکت ها تایید می شوند. با فرض اینکه هم مخزن و هم درخواست کشش با مقادیر Hacktoberfest همراستا باشند، تا زمانی که (1) درخواست کشش ادغام شده باشد و (2) مخزن موضوع “هکتوبرفست” را داشته باشد، یک مشارکت حساب خواهد شد..
جدی، همین! تا زمانی که این دو معیار برآورده شوند، هیچ اقدام دیگری از سوی نگهدارنده یا مشارکت کننده مورد نیاز نیست. همانطور که در پست قبلی بحث کردیم، مسائل، تعهدات و برچسب “hacktoberfest” محاسبه نمی شود.
برای جزئیات بیشتر در مورد ادغام، به گنجاندن تغییرات از یک درخواست کشش در GitHub Docs مراجعه کنید.
دادن یک درخواست کشش برچسب “هکتوبرفست پذیرفته شده”.
برچسب “هکتوبرفست پذیرفته شده” راه حلی برای نگهبانان است تا در صورت عدم رعایت یک یا هر دو شرایط ذکر شده، درخواست های یکباره را به صورت دستی تایید کنند. توجه داشته باشید که درخواست های کششی باید با علامت “آماده برای بررسی” (نه “پیش نویس”) علامت گذاری شوند تا واجد شرایط اعتبار Hacktoberfest شوند.
برای پاسخ به سؤالات ابتدایی ما، این کاملاً به نگهدارنده بستگی دارد که آیا و چگونه برچسب “هکتوبرفست پذیرفته شده” را اعمال کنند. برخی از نگهدارنده‌ها ممکن است در واقع بر اساس اولویت اول، اولین سرویس کار کنند. دیگران، اگر زمان بیشتری در اختیار داشته باشند، ممکن است بتوانند در صورت درخواست‌های کشش تکراری، اعتبار را به چندین مشارکت‌کننده اعطا کنند.
شرایط دیگری که در آن نگهدارنده ممکن است از برچسب “هکتوبرفست پذیرفته شده” استفاده کند چیست؟
این مخزن موضوع “هکتوبرفست” را ندارد
بگویید که به طور منظم در تمام طول سال به یک مخزن کمک می کنید. متأسفانه، نگهبانان پهنای باند لازم برای شرکت در Hacktoberfest را ندارند.
با توجه به اینکه قبلاً یک رابطه با نگهبانان دارید، ممکن است لطفاً بپرسید که آیا آنها می‌خواهند برچسب “هکتوبرفست پذیرفته شده” را برای درخواست جذب شما اعمال کنند. به این ترتیب، می توانید بدون نیاز به نگهبانان برای باز کردن دروازه ها به روی همه مشارکت کنندگان Hacktoberfest، اعتبار دریافت کنید.
درخواست کشش ادغام نشده است
شاید شما یک مشارکت معنی‌دار ارسال کرده‌اید، اما نگهبانان تشخیص داده‌اند که درخواست جذب شما کاملاً آماده ادغام آن‌طور که هست نیست. به جای اینکه از شما بخواهند تغییرات لازم را ایجاد کنید، ممکن است برای قدردانی از تلاش شما، به سادگی برچسب “هکتوبرفست پذیرفته شده” را به درخواست جذب ادغام نشده شما اضافه کنند.
در پایان روز، نگهبانان آزادند که به صلاحدید خود از برچسب “هکتوبرفست پذیرفته شده” استفاده کنند و از مشارکت کنندگان خواسته می شود به تصمیم آنها احترام بگذارند.
ارائه یک بررسی تایید کلی برای درخواست کشش در مخزن با موضوع “هکتوبرفست”
برخی از نگهدارنده‌ها مخازن خود را به گونه‌ای ساختار داده‌اند که درخواست‌های کششی جدید باید قبل از ادغام، تحت بررسی‌های دور قرار گیرند. به آن مانند روبریکی فکر کنید که به طور خودکار به درخواست کشش شما هنگام ارسال آن پیوست می شود.
به عنوان مثال، فرض کنید یک مخزن دارای پنج نگهدارنده است. آنها ممکن است مخزن خود را به گونه ای تنظیم کنند که درخواست های کششی قبل از فعال شدن ادغام، نیازمند بررسی های تأیید حداقل دو نفر از آنها باشد. یا اگر امضای یک نگهدارنده خاص مورد نیاز است، آنها می توانند مخزن را پیکربندی کنند تا بررسی درخواست کشش جدید به طور خودکار به آن شخص اختصاص داده شود.
با نیاز به پست های بازرسی متعدد، نگهبانان می توانند اطمینان حاصل کنند که تیم های آنها مطابق با الزامات داخلی هستند. داشتن چشم‌های بیشتر برای تشخیص اشتباهات، در برابر خطاهایی که از میان شکاف‌ها می‌لغزند محافظت می‌کند.
یک “بررسی تایید کلی” به طور کلی به این معنی است که درخواست کشش حداقل معیارهای ادغام شدن را پشت سر گذاشته است، حتی اگر هنوز ادغام نشده باشد. به دنبال چک مارک ها باشید!
در نهایت توجه داشته باشید که درخواست‌های کشش نباید بسته شوند تا از طریق بررسی تأیید کلی برای Hacktoberfest حساب شوند..
برای هر آنچه که در مورد بررسی ها باید بدانید، به بررسی تغییرات در درخواست های کشش در GitHub Docs مراجعه کنید.
نتیجه گیری
با چرخش به سناریوی بالای مقاله، اکنون متوجه شدیم که ممکن است چندین مشارکت کننده برای رفع یک مشکل اعتبار دریافت کنند، تا زمانی که نگهدارنده برچسب “هکتوبرفست پذیرفته شده” را برای هر یک از آنها اعمال کند. درخواست های کششی با این حال، با توجه به اینکه Hacktoberfest یک فصل شلوغ از سال برای نگهبانان است، تضمین نمی شود که آنها برای این کار وقت داشته باشند.
با در نظر گرفتن این موضوع، احتمالاً هنوز هم ایده خوبی است که شما نظری را در این شماره بگذارید و بگویید که در حال کار روی آن هستید، اگر هیچ چیز دیگری جز به نفع سایر مشارکت کنندگان نباشد. احساس قدرت کنید که ارتباطات را در دستان خود بگیرید، حتی اگر نگهدارنده مسائلی را تعیین نکند، و دیگران از تلاش شما برای کمک به کاهش سردرگمی قدردانی خواهند کرد.
در طول دو پست گذشته، ما خلاصه کرده ایم چی برای جستجو در یک مخزن حالا بیایید به آن شیرجه بزنیم چگونه برای جستجوی یک مخزن
✒️ همکاران، برخی از اشتباهات مبتدی که در گذشته مرتکب شده‌اید و دوست داشتید یکی به شما درباره آن هشدار داده بود، چیست؟
📝 نگهبانان، برخی از نکات دردناک شما چیست که آرزو می‌کنید کدنویس‌های جدید بیشتر از آن آگاه باشند؟
در زیر نظر دهید و بیایید دانش را گسترش دهیم!
تصویر از نائومی گچستر
این ارسالی برای چالش نویسندگی Hacktoberfest 2024: تجربه مشارکت‌کننده است
به 6 چیزی که درباره Hacktoberfest (زمانی که در حال یادگیری کدنویسی هستید) به شما نمی گویند خوش آمدید. در این مجموعه، نکاتی را برای کدنویسان خودآموخته به اشتراک می گذاریم که منابع رسمی Hacktoberfest ممکن است آنها را پوشش ندهند.
لطفاً توجه داشته باشید که در حالی که مشارکت‌کنندگان می‌توانند از GitHub یا GitLab برای شرکت در Hacktoberfest استفاده کنند، ما در این مقاله فقط درباره GitHub صحبت خواهیم کرد.
در حین مرور مخازن Hacktoberfest، متوجه شدم که برخی از نگهبانان درخواست کرده اند که مشارکت کنندگان از آنها نخواهند که مسائل را تعیین کنند. (یعنی “اگر می خواهید روی مشکلی کار کنید، فقط آن را انجام دهید و سپس یک درخواست کشش برای من ارسال کنید.”)
این باعث شد که من تعجب کنم: اگر مشکلی تعیین نشده باشد، چه کسی اعتبار را دریافت می کند اگر چندین نفر درخواست کنند که آن را برطرف کند؟ اگر هر یک از آنها پاسخی متفاوت و در عین حال متضاد به یک مشکل ارائه دهند، آیا اولین مشارکتی که ارائه شده است ادغام می شود یا راه حلی است که نگهدارنده بیشتر دوست دارد؟
علاوه بر این، آیا تنها درخواست کششی که ادغام می شود، حساب می شود؟ به عبارت دیگر، آیا ممکن است بیش از یک مشارکت کننده برای کار بر روی یک موضوع اعتبار دریافت کنند یا اینکه ما به عنوان مشارکت کننده باید برای دریافت دیب با یکدیگر رقابت کنیم؟
پاسخ به تمام سوالات فوق این است: بستگی دارد. برای درک دلیل، اجازه دهید راه های متعددی را که نگهبانان می توانند درخواست های کشش را تأیید کنند، بررسی کنیم.
ادغام یک درخواست کشش در یک مخزن با موضوع “هکتوبرفست”.
موضوع “هکتوبرفست” خودکارترین وسیله ای است که با آن مشارکت ها تایید می شوند. با فرض اینکه هم مخزن و هم درخواست کشش با مقادیر Hacktoberfest همراستا باشند، تا زمانی که (1) درخواست کشش ادغام شده باشد و (2) مخزن موضوع “هکتوبرفست” را داشته باشد، یک مشارکت حساب خواهد شد..
جدی، همین! تا زمانی که این دو معیار برآورده شوند، هیچ اقدام دیگری از سوی نگهدارنده یا مشارکت کننده مورد نیاز نیست. همانطور که در پست قبلی بحث کردیم، مسائل، تعهدات و برچسب “hacktoberfest” محاسبه نمی شود.
برای جزئیات بیشتر در مورد ادغام، به گنجاندن تغییرات از یک درخواست کشش در GitHub Docs مراجعه کنید.
دادن یک درخواست کشش برچسب “هکتوبرفست پذیرفته شده”.
برچسب “هکتوبرفست پذیرفته شده” راه حلی برای نگهبانان است تا در صورت عدم رعایت یک یا هر دو شرایط ذکر شده، درخواست های یکباره را به صورت دستی تایید کنند. توجه داشته باشید که درخواست های کششی باید با علامت “آماده برای بررسی” (نه “پیش نویس”) علامت گذاری شوند تا واجد شرایط اعتبار Hacktoberfest شوند.
برای پاسخ به سؤالات ابتدایی ما، این کاملاً به نگهدارنده بستگی دارد که آیا و چگونه برچسب “هکتوبرفست پذیرفته شده” را اعمال کنند. برخی از نگهدارنده‌ها ممکن است در واقع بر اساس اولویت اول، اولین سرویس کار کنند. دیگران، اگر زمان بیشتری در اختیار داشته باشند، ممکن است بتوانند در صورت درخواست‌های کشش تکراری، اعتبار را به چندین مشارکت‌کننده اعطا کنند.
شرایط دیگری که در آن نگهدارنده ممکن است از برچسب “هکتوبرفست پذیرفته شده” استفاده کند چیست؟
این مخزن موضوع “هکتوبرفست” را ندارد
بگویید که به طور منظم در تمام طول سال به یک مخزن کمک می کنید. متأسفانه، نگهبانان پهنای باند لازم برای شرکت در Hacktoberfest را ندارند.
با توجه به اینکه قبلاً یک رابطه با نگهبانان دارید، ممکن است لطفاً بپرسید که آیا آنها می‌خواهند برچسب “هکتوبرفست پذیرفته شده” را برای درخواست جذب شما اعمال کنند. به این ترتیب، می توانید بدون نیاز به نگهبانان برای باز کردن دروازه ها به روی همه مشارکت کنندگان Hacktoberfest، اعتبار دریافت کنید.
درخواست کشش ادغام نشده است
شاید شما یک مشارکت معنی‌دار ارسال کرده‌اید، اما نگهبانان تشخیص داده‌اند که درخواست جذب شما کاملاً آماده ادغام آن‌طور که هست نیست. به جای اینکه از شما بخواهند تغییرات لازم را ایجاد کنید، ممکن است برای قدردانی از تلاش شما، به سادگی برچسب “هکتوبرفست پذیرفته شده” را به درخواست جذب ادغام نشده شما اضافه کنند.
در پایان روز، نگهبانان آزادند که به صلاحدید خود از برچسب “هکتوبرفست پذیرفته شده” استفاده کنند و از مشارکت کنندگان خواسته می شود به تصمیم آنها احترام بگذارند.
ارائه یک بررسی تایید کلی برای درخواست کشش در مخزن با موضوع “هکتوبرفست”
برخی از نگهدارنده‌ها مخازن خود را به گونه‌ای ساختار داده‌اند که درخواست‌های کششی جدید باید قبل از ادغام، تحت بررسی‌های دور قرار گیرند. به آن مانند روبریکی فکر کنید که به طور خودکار به درخواست کشش شما هنگام ارسال آن پیوست می شود.
به عنوان مثال، فرض کنید یک مخزن دارای پنج نگهدارنده است. آنها ممکن است مخزن خود را به گونه ای تنظیم کنند که درخواست های کششی قبل از فعال شدن ادغام، نیازمند بررسی های تأیید حداقل دو نفر از آنها باشد. یا اگر امضای یک نگهدارنده خاص مورد نیاز است، آنها می توانند مخزن را پیکربندی کنند تا بررسی درخواست کشش جدید به طور خودکار به آن شخص اختصاص داده شود.
با نیاز به پست های بازرسی متعدد، نگهبانان می توانند اطمینان حاصل کنند که تیم های آنها مطابق با الزامات داخلی هستند. داشتن چشم‌های بیشتر برای تشخیص اشتباهات، در برابر خطاهایی که از میان شکاف‌ها می‌لغزند محافظت می‌کند.
یک “بررسی تایید کلی” به طور کلی به این معنی است که درخواست کشش حداقل معیارهای ادغام شدن را پشت سر گذاشته است، حتی اگر هنوز ادغام نشده باشد. به دنبال چک مارک ها باشید!
در نهایت توجه داشته باشید که درخواست‌های کشش نباید بسته شوند تا از طریق بررسی تأیید کلی برای Hacktoberfest حساب شوند..
برای هر آنچه که در مورد بررسی ها باید بدانید، به بررسی تغییرات در درخواست های کشش در GitHub Docs مراجعه کنید.
نتیجه گیری
با چرخش به سناریوی بالای مقاله، اکنون متوجه شدیم که ممکن است چندین مشارکت کننده برای رفع یک مشکل اعتبار دریافت کنند، تا زمانی که نگهدارنده برچسب “هکتوبرفست پذیرفته شده” را برای هر یک از آنها اعمال کند. درخواست های کششی با این حال، با توجه به اینکه Hacktoberfest یک فصل شلوغ از سال برای نگهبانان است، تضمین نمی شود که آنها برای این کار وقت داشته باشند.
با در نظر گرفتن این موضوع، احتمالاً هنوز هم ایده خوبی است که شما نظری را در این شماره بگذارید و بگویید که در حال کار روی آن هستید، اگر هیچ چیز دیگری جز به نفع سایر مشارکت کنندگان نباشد. احساس قدرت کنید که ارتباطات را در دستان خود بگیرید، حتی اگر نگهدارنده مسائلی را تعیین نکند، و دیگران از تلاش شما برای کمک به کاهش سردرگمی قدردانی خواهند کرد.
در طول دو پست گذشته، ما خلاصه کرده ایم چی برای جستجو در یک مخزن حالا بیایید به آن شیرجه بزنیم چگونه برای جستجوی یک مخزن
✒️ همکاران، برخی از اشتباهات مبتدی که در گذشته مرتکب شده‌اید و دوست داشتید یکی به شما درباره آن هشدار داده بود، چیست؟
📝 نگهبانان، برخی از نکات دردناک شما چیست که آرزو می‌کنید کدنویس‌های جدید بیشتر از آن آگاه باشند؟
در زیر نظر دهید و بیایید دانش را گسترش دهیم!
تصویر از نائومی گچستر
این ارسالی برای چالش نویسندگی Hacktoberfest 2024: تجربه مشارکت‌کننده است
