بخاطر ترجمه ضعیف شرمندم میتونین نسخه فینگلیش رو بخونین که قطعا بهتره
سخته . همیشه سخته که برای اولین بار کاری رو انجام بدی. مخصوصا وقتی داری همکاری میکنی. اشتباه کردن چیز راحتی نیست. اما دنیای متن باز تماماً درباره مشارکت و همکاری هست. ما میخواستیم تا راه رو ساده کنیم تا مشارکت کننده های جدید این همکاری رو برای بار اول یاد بگیرن
خوندن مقالات و نگاه کردن ویدیو های آموزشی میتونه کمک کنه. اما چی از واقعاً انجام دادن کار بدون خرابکاری بهتره ؟ هدف این پروژه فراهم کردن یک راهنما و ساده کردن مسیر برای تازه کار هاست تا اولین مشارکت رو انجام بدن. یادت باشه: هرچی ریلکس تر باشی. بهتر یاد میگیری. اگه میخوای اولین همکاریت رو انجام بدی فقط راهنمای قدم به قدم ساده زیر رو انجام بده. ما قول میدیم. خوش میگذره
اگه روی دستگاهت گیت نداری. نصبش کن.
این ریپوزیتوری رو از طریق کلیک کردن روی دکمه فورک بالای این صفحه فورک کن این کار یک کپی از ریپوزیتوری تو اکانتت میسازه
حالا ریپ و رو داخل کامپیوترت کلون کن. روی دکمه کلون کلیک کن و بعد روی (کپی در کلیپبورد) کلیک کن
ترمینال رو باز کن و دستورات زیر رو وارد کن
git clone "لینکی که کپی کردی"
جایی که (لینکی که کپی کردی) هست درواقع آدرس ریپوزیتوری هست که تو قدم پیش دیدی
برای مثال
git clone https://github.com/this-is-you/first-contributions.git
داخل لینک بجای
this-is-you
نام کاربری گیتهاب خودت رو قرار بده
تو این مرحله داری محتویات ریپوزیتوری رو از گیتهاب کپی میکنی تو کامپیوتر خودت
اگه هنوز داخل پوشه ریپوزیتوری نیستی. برو داخلش
cd first-contributions
حالا با استفاده از دستور
git checkout
یک برنچ جدید بساز
git checkout -b <add-your-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-name>
اسم
<add-your-name>
رو با اسم برنچی که ساخته بودی عوض کن
اگه بری داخل ریپوزیتوریت تو گیتهاب. میبینی که دکمه
Compare & pull request
وجود داره . روش کلیک کن
حالا دستور پل رو ثبت کن
بزودی من تمام تغیرات تو رو به شاخه اصلی این پروژه اضافه میکنم زمانی که تغیرات ثبت شد یک ایمیل دریافت میکنی
مشارکتت جشن بگیر و با دوستات و دنبال کننده هات به اشتراک بزار web app.
در صورتی که سوالی داشتی یا کمک خواستی میتونی به گروه اسلک ما ملحق بشی Join slack team.
Now let's get you started with contributing to other projects. We've compiled a list of projects with easy issues you can get started on. Check out the list of projects in web app.
GitHub Desktop | Visual Studio 2017 | GitKraken |
If you liked this project, star it on GitHub. If you're feeling especially charitable, follow Roshan on Twitter and GitHub.