این پروژه قصد دارد تا مسیر مشارکت در پروژه‌های متن‌باز را برای تازه‌کارها آسان نماید. اگر شما نیز بدنبال راهی برای ثبت اولین مشارکت خود هستید، این اقدامات را دنبال کنید.
اگر با محیط کامندی (CLI) احساس راحتی نمی‌کنید، راهنمای استفاده از ابزارهای گرافیکی (GUI) را مشاهده کنید.
اگر نرم‌افزار git را آماده ندارید، از اینجا نصب کنید.
با کلیک کردن بر روی دکمه Fork، از مخزن مورد نظر یک انشعاب بگیرید. این عملیات یک نسخه کپی از مخزن را بر روی حساب کاربری شما ایجاد می‌کند.
حال، از مخزن فورک شده، یک کلون روی سیستم کاربری خود ایجاد کنید. وارد حساب کاربری خود شده و مخزن فورک شده را باز کنید. دکمه Code را فشرده و نماد copy to clipboard را انتخاب کنید.
سپس یک ترمینال باز کنید و دستور گیت زیر را اجرا نمایید:
git clone "url you just copied"
بطوری که در قسمت "url you just copied"، آدرس مخزن فورک شده بدون علامت‌های کوتیشن (نقل قول) قرار گیرد.
بعنوان مثال:
git clone https://github.com/this-is-you/first-contributions.git
بطوری که عبارت this-is-you برابر با نام حساب کاربری گیت‌هاب شما باشد. با این اقدام، تمام محتوای مورد نیاز جهت مشارکت را بر روی سیستم خود آماده می‌سازید.
اگر در مسیر مخزن کلون شده قرار ندارید، با دستور زیر وارد مسیر مخزن شوید:
cd first-contributions
با استفاده از دستور git checkout یک شاخه جدید ایجاد کنید:
git checkout -b your-new-branch-name
بعنوان مثال:
git checkout -b add-alonzo-church
(هیچ لزومی نیست که در نام شاخه از کلمه add استفاده کنید. چنانچه قرار است بعنوان مشارکت، نام خود را به یک لیست اضافه کنیم، استفاده از این کلمه بعنوان نام شاخه، امری عاقلانه می‌باشد.)
در این قدم، ابتدا فایل Contributors.md را در یک محیط ویرایش متن باز کنید. نام خود را به این فایل اضافه کنید. توجه کنید که نام نه در ابتدا و نه در انتها قرار گیرد. نام را بین اسامی قرار دهید. فایل را ذخیره کنید.
چنانچه وارد مسیر مخزن شوید و دستور git status را اجرا نمایید، مشاهده خواهید کرد که تغییراتی بر روی مخزن اعمال شده.
با استفاده از دستور git add، تغییرات را به برنچ از پیش ساخته‌شده اضافه کنید:
git add Contributors.md
حال، تغییرات را با دستور git commit کامیت و ثبت نمایید:
git commit -m "Add <your-name> to Contributors list"
توجه داشته باشید که نام خود را با عبارت <your-name> جایگزین کنید.
با استفاده از دستور git push تغییرات ثبت شده را ارسال کنید:
git push origin <add-your-branch-name>
نام برنچی که در مراحل قبل ایجاد کردید را با عبارت <add-your-branch-name> جایگزین کنید.
چنانچه وارد مخزن فورک شده در حساب کاربری خود شوید، گزینه‌ای تحت عنوان Compare & pull request مشاهده خواهید کرد. آن گزینه را انتخاب کنید.
در این مرحله، درخواست (Pull request) خود را ثبت کنید.
نهایتا، من تغییرات شما را به برنچ master پروژه اضافه (merge) خواهم کرد. بلافاصله پس از مرج شدن درخواست شما، یک ایمیل مبنی بر همین موضوع برای شما ارسال خواهد شد.
تبریک! شما مراحل فورک کردن، کلون کردن، ایجاد تغییرات و پول رکوئست را به خوبی پشت سر گذاشتید.
مشارکت خود روی این پروژه را از اینجا با دیگر دوستان و دنبال‌کنندگان خود جشن بگیرید.
همچنین شما می‌توانید از اینجا، وارد تیم Slack ما شوید و سوالات خود را مطرح نمایید.
حال، شما می‌توانید مشارکت خود را روی دیگر پروژه‌ها آغاز نمایید. ما یک لیست از پروژه‌ها با مشکلات ساده ایجاد کردیم که گزینه خوبی برای شروع می‌باشد. لیست پروژه‌ها را از این اینجا دنبال کنید.
 |
 |
 |
 |
 |
 |
|---|---|---|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |