نخستین همکاری

این پروژه قصد دارد تا راه همکاری در پروژه‌های متن‌باز را برای تازه‌کارها آسان نماید. اگر شما نیز به دنبال راهی برای ثبت نخستین همکاری خود هستید، این گام ها را دنبال کنید.

اگر با محیط خط فرمان (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) خواهم کرد. بی درنگ پس از مرج شدن درخواست شما، یک ایمیل بر پایه همین زمینه برای شما فرستاده خواهد شد.

کارهای پسین

تبریک! شما گامهای فورک کردن، کلون کردن، ویرایش کردن و پول رکوئست را به خوبی پشت سر گذاشتید.

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

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