نحوه استفاده از Git برای مشارکت در نرم افزار منبع باز

شاید در مورد Git و متن باز شنیده باشید، اما آیا می دانید که چگونه آنها در کنار هم برای بهبود توسعه نرم افزار کار می کنند؟

Learning Git یک مهارت ضروری در توسعه نرم افزار است. محبوبیت روزافزون نرم افزار منبع باز منجر به موفقیت Git شده است. می توانید از آن برای پیگیری مشارکت ها، مدیریت همکاری و میزبانی پایگاه های کد در مخازن راه دور استفاده کنید.

Git در اکثر پروژه های منبع باز نقش حیاتی ایفا می کند. دریابید که Git چه رابطه ای با منبع باز دارد و چگونه می توانید از این ابزار سازنده برای افزایش مشارکت خود استفاده کنید.

رابطه بین Git و منبع باز

Git یک نرم افزار کنترل نسخه است که به طور گسترده در توسعه استفاده می شود. Git به شما امکان می دهد تغییرات نرم افزار را در زمان واقعی ردیابی کنید، کپی های کد خود را در مخازن راه دور ذخیره کنید و به صورت آنلاین همکاری کنید. در آموزش پیشرفته Git ما نگاهی عمیق به Git بیندازید.

Git همچنین یک پروژه منبع باز است که مشارکت کنندگان در طول زمان برای بهبود آن کار کرده اند. نرم‌افزار متن‌باز عموماً برای همه رایگان است. زمانی که مالک به هر کسی حق استفاده، تغییر و توزیع کد منبع را بدهد، نرم‌افزار منبع باز می‌شود.

مشارکت‌های منبع باز به شیوه‌ای عمومی و مشارکتی انجام می‌شوند که به عنوان «ساخت در عموم» نیز شناخته می‌شود. درباره تفاوت بین نرم افزار منبع باز و منبع بسته بیشتر بدانید.

Git دارای ویژگی های مشترک است که در منبع باز ضروری است. Git تیم ها را قادر می سازد تا پروژه ها را به طور مشترک حفظ کنند. این به شما امکان می‌دهد کد را واکشی کنید، مشارکت‌هایی را در دستگاه محلی خود اضافه کنید و تغییرات خود را برای بررسی ارسال کنید.

ویژگی های Git مورد استفاده در منبع باز

Git چندین دستور دارد که برای انجام عملیات روی رابط خود استفاده می شود. بسیاری از این دستورات وجود دارد، اما برای کمک به منبع باز نیازی به یادگیری همه آنها ندارید. در اینجا برخی از اصطلاحات و دستورات اساسی وجود دارد که با آنها روبرو خواهید شد:

• Fork: یک کپی از یک مخزن GitHub (repo). هنگامی که یک فورک درست می‌کنید، یک کپی از آن را در حساب GitHub خود دریافت می‌کنید، که به شما امکان می‌دهد بدون تأثیر بر مخزن اصلی پروژه، محتویات را ویرایش کنید.
• مسئله: یک ایده، اشکال یا وظیفه ای که ممکن است مشارکت کنندگان روی آن کار کنند. یک مشکل با برچسبی مانند اولین شماره خوب، یک کار ساده است که به منظور ایجاد انگیزه در مشارکت کنندگان برای مشارکت در پروژه های منبع باز است.
• برچسب: برای دسته بندی مسائل و بحث ها استفاده می شود.
• Maintainers: مشارکت کنندگان با اجازه تغییر فایل های موجود در مخزن پروژه. آنها همچنین به عنوان صاحبان کد شناخته می شوند.
• مشارکت کنندگان: هر کسی که کد، مستندات، یا سایر منابع فنی را به یک پروژه کمک می کند.

در زیر برخی از دستورات رایجی که در توسعه منبع باز استفاده خواهید کرد آمده است:

• شعبه: یک کپی از محتویات مخزن. یک مخزن می تواند چندین شعبه داشته باشد: شعبه اصلی و چندین شعبه دیگر، در صورت لزوم. شاخه پیش فرض main/master است و می توانید شاخه های اضافی را با توجه به هدف آنها نامگذاری کنید.
• Merge: Merge به معنای پیوستن شاخه های مختلف به یکدیگر است به طوری که آنها کد یکسانی داشته باشند.
• درخواست کشش (PR): به تعمیر و نگهداری اطلاع می دهد که کدی را وارد کرده اید که باید بازبینی شود. زمانی که آماده ادغام با شعبه والد هستید و نیاز به بازبینی دیگران دارید، درخواست کشش بدهید.
• راه دور: نسخه آنلاین مخزن محلی شما.
• واکشی: محتوای یک مخزن راه دور را در مخزن محلی شما بارگیری می کند.
• Commit: تغییرات یک فایل را در یک مخزن محلی یا آنلاین ردیابی می کند. همه commit ها دارای یک شناسه منحصر به فرد هستند که جزئیات مربوط به نویسنده، زمان و ماهیت تغییرات ایجاد شده را ثبت می کند.

شروع کار با منبع باز

در این آموزش، ما به مراحل اولیه ای که برای اولین مشارکت خود در منبع باز بردارید، نگاه خواهیم کرد. ما از Git به عنوان مخزن محلی و از GitHub به عنوان مخزن راه دور استفاده خواهیم کرد. در اینجا نحوه شروع شما آمده است.

1. یک پروژه را انتخاب کنید

یک پروژه مناسب برای مشارکت را شناسایی کنید. مهارت ها و اشتیاق شما برای ایجاد تفاوت تعیین می کند که کدام پروژه را انتخاب می کنید. شما می توانید یک ویژگی، مستندات یا مهارت هایی مانند مدیریت محصول را به اشتراک بگذارید.

پروژه مناسب یک جامعه فعال در کانال های اجتماعی مانند Slack یا Twitter خواهد داشت. مخزن آن باید مشارکت های منظم و مجوز مناسب برای نرم افزار منبع باز داشته باشد.

2. راهنمای مشارکت کنندگان را دریافت کنید

هر پروژه منبع باز معتبر باید راهنمای مشارکت کنندگان داشته باشد. این راهنما دارای دستورالعمل‌ها و دستورالعمل‌هایی است که به توسعه‌دهندگان جدید نشان می‌دهد چگونه در پروژه مشارکت کنند.

شما یاد خواهید گرفت که چگونه فورک کنید، روی یک مشکل کار کنید، و یک درخواست کشش به مخزن بالادستی ارائه دهید تا به نگهبانان اجازه دهید مشارکت شما را بررسی کنند. به احتمال زیاد راهنمای مشارکت کنندگان را در پوشه اصلی پروژه خواهید یافت.

راهنمای مشارکت کنندگان به شما کمک می کند تا گردش کار پروژه را درک کنید و تضادهای ادغام را کاهش دهید. اگر به این دستورالعمل‌های مشارکت‌کنندگان پایبند نباشید، نگهدارنده ممکن است درخواست کشش شما را رد کند.

در اینجا نمونه ای از راهنمای مشارکت کنندگان از پروژه AsyncAPI آمده است.

3. یک مسئله را انتخاب کنید

یک مشکل می تواند هر چیزی باشد که شما دوست دارید در آن مشارکت داشته باشید. این می تواند درخواستی باشد که در بخش مسائل موجود در مخزن پروژه شناسایی کرده اید، اشتباه تایپی یا اسنادی که می خواهید به پروژه اضافه کنید.

قبل از شروع کار روی یک موضوع، ابتدا در مورد آن پرس و جو کنید یا با نگهبانان در مورد آن بحث کنید. گاهی اوقات ممکن است یک مسئله قدیمی باشد یا یکی دیگر از همکاران در حال کار روی آن است. بخش مشکلات در GitHub به این صورت است:

4. روی موضوع کار کنید

هنگامی که نگهبانان مشکل را تأیید کردند، می توانید یک مخزن فورکی راه اندازی کنید. Forking یک کپی از مخزن والد را به مخزن شما می رساند. شما با دستور git clone مخزن را در ماشین محلی خود کلون خواهید کرد.

می توانید پوشه را در ویرایشگر کد دلخواه خود باز کرده و شروع به کار کنید. در اینجا، دانستن نحو زبان‌های نشانه‌گذاری محبوب مانند Markdown، که در اکثر پروژه‌های منبع باز محبوب است، ضروری است. اگر روی یک مشکل مستندات کار می کنید، احتمالاً از Markdown همانطور که در زیر نشان داده شده است استفاده خواهید کرد:

5. کار خود را برای بررسی ارسال کنید

پس از پایان کار بر روی مشکل، گردش کار راهنمای مشارکت کنندگان را دنبال کنید تا کار خود را برای بررسی به GitHub هدایت کنید. از مراحل زیر برای پیکربندی فورک و ارسال آن برای بررسی استفاده کنید.

1. مخزن محلی خود را با استفاده از این دستور به مخزن بالادست پروژه متصل کنید: git remote add upstream https://github.com/{original-owner}/{original-repository}.git
2. از git fetch برای دانلود محتویات شاخه upstream در شعبه محلی خود استفاده کنید: git branch -u upstream/master master
3. یک شاخه جدید با شاخه git <نام شعبه جدید> ایجاد کنید. با دستور git branch می توانید بررسی کنید که آیا شاخه جدید ایجاد شده است.
4. شاخه خود را با git add مرحله بندی کنید و آن را با git commit -m commit کنید.
5. کد خود را به شاخه GitHub با مبدا git push <نام شاخه> فشار دهید.
6. درخواست کشش (PR) بدهید. یک روابط عمومی به نگهبانان هشدار می دهد که شعبه شما را بررسی کنند و قبل از ادغام تغییراتی را پیشنهاد کنند. این نمودار کل فرآیند را خلاصه می کند.

git remote add upstream https://github.com/{original-owner}/{original-repository}.git

git branch -u upstream/master master

6. بررسی و ادغام

پس از ارائه PR، نگهبانان احتمالا تغییرات را بررسی و پیشنهاد خواهند کرد. می توانید تغییرات محلی ایجاد کنید یا تغییرات پیشنهادی را در مخزن راه دور انجام دهید. GitHub یک شرط برای انجام تغییرات از راه دور دارد.

در طول بررسی، بازخوردی در مورد مشارکت خود دریافت خواهید کرد و می توانید در مورد برخی موارد توضیح دهید. در زیر تصویری از نحوه انجام تغییرات در GitHub آورده شده است:

وقتی تغییرات را تمام کردید، تعهدات جدیدی را ایجاد کنید. Commits به نگهبانان اطلاع می دهد که کار شما را دوباره بررسی کنند. اگر همه چک ها تایید شوند، روابط عمومی شما به سرعت ادغام می شود. تبریک می گویم! شما به تازگی اولین مشارکت خود را در یک پروژه منبع باز انجام داده اید.

Git همکاری منبع باز را افزایش می دهد

Git نقش اساسی در مشارکت های منبع باز ایفا می کند. Git پروژه‌های بزرگ و کوچک را قادر می‌سازد تا مشارکت‌های تیم‌ها را ردیابی کنند و نسخه‌های مختلف کدهای منبع را میزبانی کنند. به عنوان یک پروژه منبع باز، Git کیفیت و کمیت مشارکت در نرم افزار منبع باز را افزایش داده است.

اولین مشارکت منبع باز شما احتمالاً ترسناک خواهد بود، اما زمانی که جریان کار را یاد بگیرید آسان و سرگرم کننده است. استفاده از Git به شما کمک می کند تا مهارت های کدنویسی خود را تقویت کنید، همکاری را بیاموزید و با بهترین افراد در صنعت فناوری ارتباط برقرار کنید. برو جلو و شروع کن!

منبع مقاله