پرش به محتوا
آموزش و مهارتراهنما

مشارکت در پروژه‌های متن‌باز؛ از اولین Issue تا Pull Request

تتحریریه امروزینو۲۲ مرداد ۱۴۰۵۳ دقیقه مطالعه۲۱۰ بازدید
مشارکت در پروژه‌های متن‌باز؛ از اولین Issue تا Pull Request

راهنمای گام‌به‌گام مشارکت در پروژه‌های متن‌باز؛ پیدا کردن Issue مناسب، احترام به قوانین پروژه و ارسال Pull Requestی که پذیرفته می‌شود.

متن‌باز چیست و چرا ارزش وقت دارد؟

نرم‌افزار متن‌باز یعنی کدی که منبعش عمومی است؛ هر کسی می‌تواند آن را بخواند، استفاده کند و بهترش کند. چرخ‌دنده‌های دنیای مدرن روی همین کدها می‌چرخند: از سیستم‌عامل گوشی‌تان تا سرورهای بزرگ‌ترین سایت‌های دنیا. و نکتهٔ جذاب برای شما: این پروژه‌ها همیشه به دست کمکی نیاز دارند، از غلط املایی در مستندات تا باگ‌های واقعی.

مشارکت در متن‌باز سه هدیهٔ بزرگ دارد: اول، کدی که در معرض دید حرفه‌ای‌های دنیاست، شما را با استانداردهای واقعی آشنا می‌کند. دوم، اسم شما کنار پروژه‌ای که هزاران نفر استفاده‌اش می‌کنند می‌نشیند؛ قوی‌ترین رزومهٔ ممکن. سوم، شما از حالت تماشاچیِ تلهٔ آموزش‌بینی خارج می‌شوید و با کدِ واقعیِ تیمیِ واقعی روبه‌رو می‌شوید. اگر اشتباهات سال اول برنامه‌نویسی را می‌خوانده باشید، می‌دانید تجربهٔ کد واقعی هیچ جانشینی ندارد.

پیدا کردن پروژه و Issue مناسب

اشتباه رایج، شروع از پروژه‌های غول‌پیکر است؛ آنجا رقابت شدید است و پاسخ‌ها کند. شروع درست از پروژه‌های متوسط و فعال است:

  • از ابزارهایی که خودتان استفاده می‌کنید شروع کنید؛ آشنایی با محصول، نصف مسیر فهمیدن کد است.
  • دنبال برچسب‌های مناسب بگردید: Issueهای دارای برچسب good first issue یا beginner friendly، دقیقاً برای تازه‌کارها برچسب خورده‌اند.
  • مستندات را دست‌کم نگیرید: اصلاح غلط تایپی، بهبود جمله‌بندی و ترجمهٔ راهنماها هم مشارکت است و بهترین بلیت ورود است.
  • فعال بودن را چک کنید: پاسخ‌های اخیر نگهدارنده‌ها به Issueهای دیگران نشان می‌دهد پروژه زنده است.

گردش کار استاندارد: Fork تا Pull Request

اول از همه، گیت و گیت‌هاب را باید راحت باشید؛ کل مسیر مشارکت روی همین ابزار است. سپس این قدم‌ها:

  • پروژه را Fork کنید و نسخهٔ خودتان را کلون بگیرید.
  • یک شاخهٔ جدید با نام کوتاه و معنادار بسازید؛ هرگز روی شاخهٔ اصلی تغییر ندهید.
  • مشکل را برطرف کنید، کوچک و متمرکز؛ یک Pull Request باید فقط یک کار انجام دهد.
  • طبق قواعد کد تمیز بنویسید و اگر پروژه فرمت و تست دارد، از آن‌ها عبور کنید.
  • تغییرات را کامیت و Push کنید و Pull Request بزنید؛ توضیحات روشن بدهید: چه مشکلی حل شد و چرا این راه‌حل.

آدابی که مشارکت‌کنندهٔ خوب را می‌سازد

  • اول Issue بزنید، بعد کد بنویسید: بپرسید «می‌توانم این را انجام دهم؟» و منتظر تأیید بمانید؛ کدی که ساعت‌ها نوشته‌اید و رد می‌شود، تلخ‌ترین تجربهٔ متن‌باز است.
  • صبور باشید اما پیگیر: نگهدارنده‌ها انسان‌های شاغل‌اند؛ اگر یک هفته پاسخی نیامد، با احترام یادآوری کنید.
  • پذیرای نقادت باشید: ممکن است بازبین سه دور تغییر بخواهد؛ هر دور، کلاس رایگان یک حرفه‌ای است.
  • لحن مکاتبات را حرفه‌ای نگه دارید: خلاصه، شفاف و محترمانه؛ PR خوب مثل ایمیل اداری است نه چت دوستانه.

از مشارکت تا اعتبار حرفه‌ای

بعد از دو سه مشارکت پذیرفته‌شده، اتفاق ظریفی می‌افتد: پروفایل گیت‌هاب شما از یک فضای خالی به ویترین تبدیل می‌شود. کارفرماها دقیقاً همین را می‌بینند؛ نه فقط کد، بلکه توانایی کار در فرایند تیمی، پذیرش بازبینی و پایبندی به قواعد. بسیاری از برنامه‌نویس‌ها اولین شغل خارجی‌شان را از دل همین فعالیت‌ها گرفتند چون مشارکت متن‌باز، اثبات عملی مهارت است؛ مدرکی که هیچ مدرک دانشگاهی‌اش را نمی‌دهد.

از یک Issue کوچک شروع کنید، همین هفته. اولین PR همیشه سخت‌ترین است؛ از دومی به بعد، شما عضوی از اکوسیستم هستید و دری که این عضویت به رویتان باز می‌کند، از هر دوره‌ای گسترده‌تر است.

این مطلب برایتان مفید بود؟

با پسندیدن، به ما کمک می‌کنید مطالب بهتری منتشر کنیم.

مطالب مرتبط

دو طرف میز مذاکره با برگهٔ پیشنهاد شغلی و ماشین‌حساب روی میز؛ نماد مذاکره حقوق و پیشنهاد شغلی
آموزش و مهارت

مذاکره حقوق در مصاحبه و پیشنهاد شغلی؛ بدون ریسک‌کردن فرصت

بیشتر ما اولین عددی که می‌شنویم را می‌پذیریم — و همان تفاوتِ سالانه را هر سال از دست می‌دهیم. این راهنمای مذاکره حقوق برای بازار ایران و دورکاری است: تحقیقِ عدد درست، زمان‌بندیِ اعلامش در مصاحبه، جمله‌های آماده و واکنش درست به پیشنهادِ کم.

تحریریه امروزینو
۱۴۰۵/۰۸/۰۱۵ دقیقه
فلش‌کارت‌ها و تقویم مرور فاصله‌دار با فواصل ۱، ۳، ۷، ۱۴ و ۳۰ روز
آموزش و مهارت

راه‌اندازی سیستم مرور فاصله‌دار؛ از ساخت فلش‌کارت تا کار با Anki

نظریه را بلدید اما سیستم ندارید؟ راهنمای عملی راه‌اندازی مرور فاصله‌دار: چه چیزی ارزش فلش‌کارت‌شدن دارد، شش قاعدهٔ کارت خوب، جدول ۱-۳-۷-۱۴-۳۰ و روتین نگهداری روزی ۱۵ دقیقه.

تحریریه امروزینو
۱۴۰۵/۰۸/۰۱۵ دقیقه
مقایسهٔ دو حالت مطالعه؛ تماشای منفعل ویدیو در برابر یادداشت‌برداری فعال
آموزش و مهارت

یادگیری فعال و منفعل؛ تفاوت واقعی و راه تبدیل مطالعهٔ منفعل به فعال

چرا سه ساعت تماشای ویدیو هیچ مهارتی نمی‌سازد؟ تفاوت واقعی یادگیری فعال و منفعل، توهم روانی‌بودن، پنج تکنیک عملی تبدیل و نسبت طلایی ۳۰ به ۷۰ در روتین هفتگی.

تحریریه امروزینو
۱۴۰۵/۰۸/۰۱۵ دقیقه
طرح اولیهٔ یک پروژه روی میز کار؛ ساختن به‌جای فقط تماشای دوره
آموزش و مهارت

یادگیری با پروژه؛ از جمع‌کردن دوره‌ها تا ساختن مهارت واقعی

چرا دوره‌دیدن به‌تنهایی مهارت نمی‌سازد و چطور یادگیری را دور یک پروژهٔ واقعی بچینیم؟ نردبان انتخاب پروژه، چرخهٔ ساخت و یادگیری ۷۰/۳۰، دو مثال واقعی و مسیر رسیدن به نمونه‌کار.

تحریریه امروزینو
۱۴۰۵/۰۸/۰۱۶ دقیقه