Skip to content

Latest commit

 

History

History
91 lines (75 loc) · 5.34 KB

CONTRIBUTING.md

File metadata and controls

91 lines (75 loc) · 5.34 KB

راهنمای مشارکت‌کنندگان

از علاقه شما برای توسعه اسناد ری‌اکت به زبان فارسی سپاسگذاریم و این برای ما ارزشمند است. برای شروع آماده‌اید؟

یک صفحه را انتخاب کنید

در توضیحات موضوع 1# لیست صفحاتی که نیاز به ترجمه دارد آورده‌ شده‌است. اولویت ما شروع از صفحات Core Pages، با ترتیبی است که مشخص شده‌است. یکی از صفحاتی را که به موضوع آن علاقه‌مند هستید را برای شروع انتخاب کنید.

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

با نوشتن یک کامنت روی موضوع 1#، به نگاه‌دارندگان اطلاع دهید که تمایل دارید روی ترجمه چه صفحه‌ای کار کنید. پس از تایید، نام‌کاربری گیت‌هاب شما روبروی آن درج و ترجمه آن صفحه به شما واگذار می‌شود.

یک شاخه بسازید

یک انشعاب از مخزن اصلی بگیرید و یک کپی از آن را روی سیستم خود قرار دهید. مطمئن شوید که روی شاخه master هستید. یک شاخه جدید با نام دلخواه خود ایجاد کنید.

# نام کاربری گیت‌هاب خود را در آدرس زیر قرار دهید
1. git clone git@github.com:[username]/fa.reactjs.org.git
2. cd fa.reactjs.org
3. git checkout master
# نام دلخواه شاخه خود را در دستور زیر قرار دهید
4. git checkout -b [the-name-of-my-branch]

تغییرات را انجام دهید

روش اجرای پروژه در README.md توضیح داده شده‌است. فایل‌هایی که در آن‌ها تغییر انجام شده‌است را ذخیره کنید و نتیجه را در مرورگر مشاهده کنید. نتیجه تغییر فایل‌های مسیر src و content به صورت خودکار در مرورگر بارگذاری می‌شود.

تست کنید

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

1. yarn check-all

زمان ارسال تغییرات رسیده

تغییرات را با نوشتن یک پیام مناسب، کامیت کنید و به سرور گیت‌هاب بفرستید. سپس یک پول‌ریکوست به شاخه fa از مخزن اصلی ثبت کنید.

# پیام موردنظر خود را در دستور زیر جایگزین کنید
1. git add -A && git commit -m "[the-message]"
# نام کاربری گیت‌هاب و نام شاخه مورد نظر باید در دستور زیر قرارگیرد
2. git push [my-fork-name] [the-name-of-my-branch]

ثبت پول‌ریکوست

بعد از ارسال تغییرات به انشعاب خودتان، یک پول‌ریکوست از شاخه موردنظر به شاخه fa از مخزن اصلی ثبت کنید.

نکته: اگر پول ریکوست شما مستقیم به شاخه master ارسال شود، بر خلاف میل ما، مجبور به بستن آن هستیم، چون روال بررسی و تایید را دچار مشکل می کند!

کمی صبر کنید تا بررسی شود

تغییرات شما باید توسط حداقل دو نفر از نگاه‌دارندگان بررسی و تایید شود. آن‌ها در این مرحله نظر خود را با شما در میان می‌گذارند. در صورت وجود مشکل، با همکاری آن‌ها مشکل برطرف و تغییرات به شاخه fa اضافه می‌شود. پس از اینکه تیم از انتشار تغییرات جدید اطمینان حاصل کرد، ادغام با شاخه master انجام خواهدشد.


اگر فکر می‌کنید چیزی فراموش شده‌است یا نیاز به تصحیح دارد، حتما نظر خود را با ما درمیان بگذارید.