Skip to content

Latest commit

 

History

History
107 lines (77 loc) · 11.9 KB

README.fa.md

File metadata and controls

107 lines (77 loc) · 11.9 KB

Open Source Love License: MIT Open Source Helpers

اولین مشارکت

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

اگر با محیط کامندی (CLI) احساس راحتی نمی‌کنید، راهنمای استفاده از ابزارهای گرافیکی (GUI) را مشاهده کنید.

fork this repository

اگر نرم‌افزار git را آماده ندارید، از اینجا نصب کنید.

مخزن را فورک کنید

با کلیک کردن بر روی دکمه Fork، از مخزن مورد نظر یک انشعاب بگیرید. این عملیات یک نسخه کپی از مخزن را بر روی حساب کاربری شما ایجاد می‌کند.

مخزن را کلون (شبیه) کنید

clone this repository

حال، از مخزن فورک شده، یک کلون روی سیستم کاربری خود ایجاد کنید. وارد حساب کاربری خود شده و مخزن فورک شده را باز کنید. دکمه Code را فشرده و نماد copy to clipboard را انتخاب کنید.

سپس یک ترمینال باز کنید و دستور گیت زیر را اجرا نمایید:

git clone "url you just copied"

بطوری که در قسمت "url you just copied"، آدرس مخزن فورک شده بدون علامت‌های کوتیشن (نقل قول) قرار گیرد.

copy URL to clipboard

بعنوان مثال:

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 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 مشاهده خواهید کرد. آن گزینه را انتخاب کنید.

create a pull request

در این مرحله، درخواست (Pull request) خود را ثبت کنید.

submit pull request

نهایتا، من تغییرات شما را به برنچ master پروژه اضافه (merge) خواهم کرد. بلافاصله پس از مرج شدن درخواست شما، یک ایمیل مبنی بر همین موضوع برای شما ارسال خواهد شد.

اقدامات بعدی

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

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

همچنین شما می‌توانید از اینجا، وارد تیم Slack ما شوید و سوالات خود را مطرح نمایید.

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

آموزش انجام مشارکت در دیگر ابزارها

GitHub Desktop Visual Studio 2017 GitKraken VS Code Sourcetree App IntelliJ IDEA
GitHub Desktop Visual Studio 2017 GitKraken Visual Studio Code Atlassian Sourcetree IntelliJ IDEA