Commit cacc968
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -46,9 +46,9 @@ assignees: '' | |||
| 46 | 46 | ||
| 47 | 47 | ## فرایند بررسی | |
| 48 | 48 | ||
| 49 | - <!-- این بخش را خالی نگذارید و پیش از ارسال ایشیو مطالعه کنید --> | ||
| 49 | + <!-- این بخش را خالی نگذارید و پیش از ارسال ایشو مطالعه کنید --> | ||
| 50 | 50 | ||
| 51 | - - [ ] می‌دانم که پس از تأیید اولیه‌ی نگهدارندگان، نظرسنجی هم‌زمانی در گروه تلگرام و در همین ایشیو (با گزینه‌های پسندیدن/نپسندیدن) به مدت **دو هفته** برگزار می‌شود و نتیجه بر اساس مجموع آرا مشخص خواهد شد. | ||
| 51 | + - [ ] می‌دانم که پس از تأیید اولیه‌ی نگهدارندگان، نظرسنجی هم‌زمانی در گروه تلگرام و در همین ایشو (با گزینه‌های پسندیدن/نپسندیدن) به مدت **دو هفته** برگزار می‌شود و نتیجه بر اساس مجموع آرا مشخص خواهد شد. | ||
| 52 | 52 | - [ ] می‌دانم در صورت رأی نیاوردن، می‌توانم پس از **چهار هفته** دوباره همین پیشنهاد را به رأی بگذارم. | |
| 53 | 53 | ||
| 54 | 54 | ## آیین‌نامه رفتاری | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -4,7 +4,7 @@ | |||
| 4 | 4 | ||
| 5 | 5 | همچنین واژه‌نامه‌ی پروژه به‌صورت یک وبگاه از طریق [این پیوند](http://python.github.io/python-docs-fa/glossary-searcher) در دسترس است. با جست‌وجوی واژه‌ی انگلیسی مورد نظر، می‌توانید در صورت وجود آن در واژه‌نامه، معادل فارسی ثبت‌شده‌ی آن را به‌همراه نمونه‌های کاربرد آن در پیکره‌ی مستندات مشاهده کنید. | |
| 6 | 6 | ||
| 7 | - تمام مشارکت‌کنندگان موظف‌اند از [آیین‌نامه‌ی رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنند. این تعهد در همه‌ی ایشیوها و پول‌ریکوئست‌ها به‌صورت یک چک‌باکس ثبت می‌شود. | ||
| 7 | + تمام مشارکت‌کنندگان موظف‌اند از [آیین‌نامه‌ی رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنند. این تعهد در همه‌ی ایشوها و پول‌ریکوئست‌ها به‌صورت یک چک‌باکس ثبت می‌شود. | ||
| 8 | 8 | ||
| 9 | 9 | ## شروع کار | |
| 10 | 10 | ||
@@ -38,17 +38,17 @@ | |||
| 38 | 38 | ||
| 39 | 39 | هر پرونده‌ی `.po` شامل جفت‌های `msgid` (متن انگلیسی) و `msgstr` (ترجمه‌ی فارسی) است. | |
| 40 | 40 | ||
| 41 | - ## انواع ایشیو | ||
| 41 | + ## انواع ایشو | ||
| 42 | 42 | ||
| 43 | - پیش از باز کردن ایشیوی جدید، قالب مناسب را از [صفحه‌ی ایشیوهای پروژه](https://github.com/python/python-docs-fa/issues/new/choose) انتخاب کنید. سه قالب موجود است: | ||
| 43 | + پیش از باز کردن ایشوی جدید، قالب مناسب را از [صفحه‌ی ایشوهای پروژه](https://github.com/python/python-docs-fa/issues/new/choose) انتخاب کنید. سه قالب موجود است: | ||
| 44 | 44 | ||
| 45 | 45 | - **اشکال در ترجمه:** برای گزارش ترجمه‌ی نادرست یا مشکل‌دار در یک صفحه‌ی منتشرشده. `msgid`، `msgstr` فعلی، و ترجمه‌ی پیشنهادی خود را در قالب وارد کنید. | |
| 46 | 46 | - **پیشنهاد تغییرات در ترجمه:** برای پیشنهاد تغییر در یک واژه یا شیوهی نگارشِ ثابت‌شده (نه یک اشکال ساده). فرایند بررسی این نوع پیشنهاد در بخش [«پیشنهاد تغییر در واژه یا شیوهی نگارش»](#پیشنهاد-تغییر-در-واژه-یا-شیوهی-نگارش) توضیح داده شده است. | |
| 47 | 47 | - **گزارش اشکال در واژه‌یاب:** برای گزارش اشکالات در واژه‌یاب، از این قالب استفاده کنید. | |
| 48 | 48 | ||
| 49 | 49 | ## فرایند ترجمه | |
| 50 | 50 | ||
| 51 | - 1. پرونده‌ای را انتخاب کنید و بررسی کنید آیا [ایشیوی](https://github.com/python/python-docs-fa/issues) مربوط به آن باز شده است یا نه (قالب «درخواست ترجمه‌ی صفحه»). اگر باز شده و ترجمه‌ی کامل آن در حال انجام است، پرونده‌ی دیگری را انتخاب کنید؛ در غیر این صورت یک ایشیو باز کرده و شروع به کار کنید. | ||
| 51 | + 1. پرونده‌ای را انتخاب کنید و بررسی کنید آیا [ایشوی](https://github.com/python/python-docs-fa/issues) مربوط به آن باز شده است یا نه (قالب «درخواست ترجمه‌ی صفحه»). اگر باز شده و ترجمه‌ی کامل آن در حال انجام است، پرونده‌ی دیگری را انتخاب کنید؛ در غیر این صورت یک ایشو باز کرده و شروع به کار کنید. | ||
| 52 | 52 | ||
| 53 | 53 | 2. پرونده‌ی `.po` مورد نظر را با [Poedit](https://poedit.net) یا هر ویرایشگر متنی باز کنید. | |
| 54 | 54 | - در Poedit رشته‌های ترجمه‌نشده یا `fuzzy` را از پنل فیلتر (Filter) پیدا کنید. | |
@@ -168,9 +168,9 @@ python3 scripts/update_python_version.py v3.15.0 --keep-src | |||
| 168 | 168 | با `python3 scripts/translation_status.py --only-incomplete` می‌توانید وضعیت دقیق هر پرونده را ببینید. | |
| 169 | 169 | ||
| 170 | 170 | ## گزارش اشکال در ترجمه | |
| 171 | - اگر اشکالی در ترجمه‌ی یکی از صفحه‌ها پیدا کرده‌اید، لطفاً یک ایشیو با قالب «اشکال در ترجمه» ایجاد کنید. | ||
| 171 | + اگر اشکالی در ترجمه‌ی یکی از صفحه‌ها پیدا کرده‌اید، لطفاً یک ایشو با قالب «اشکال در ترجمه» ایجاد کنید. | ||
| 172 | 172 | ||
| 173 | - در ایشیو، لطفاً موارد زیر را ذکر کنید: | ||
| 173 | + در ایشو، لطفاً موارد زیر را ذکر کنید: | ||
| 174 | 174 | ||
| 175 | 175 | - محل دقیق ترجمه‌ی مشکل‌دار (مسیر پرونده یا لینک صفحه) | |
| 176 | 176 | - در صورت نیاز، تصویری از ترجمه | |
@@ -181,15 +181,15 @@ python3 scripts/update_python_version.py v3.15.0 --keep-src | |||
| 181 | 181 | ||
| 182 | 182 | اگر می‌خواهید تغییری در ترجمه‌ی یک واژه‌ی موجود در واژه‌نامه یا در یکی از شیوه‌های نگارشی رایج پروژه پیشنهاد دهید، این فرایند را دنبال کنید: | |
| 183 | 183 | ||
| 184 | - 1. یک ایشیو با قالب **«پیشنهاد تغییرات در ترجمه»** باز کنید. | ||
| 185 | - 2. پس از بررسی و تأیید اولیه‌ی نگهدارندگان پروژه، یک نظرسنجی هم‌زمان در گروه تلگرام و در همان ایشیوی گیت‌هاب (با گزینه‌های پسندیدن/نپسندیدن) آغاز می‌شود. | ||
| 184 | + 1. یک ایشو با قالب **«پیشنهاد تغییرات در ترجمه»** باز کنید. | ||
| 185 | + 2. پس از بررسی و تأیید اولیه‌ی نگهدارندگان پروژه، یک نظرسنجی هم‌زمان در گروه تلگرام و در همان ایشوی گیت‌هاب (با گزینه‌های پسندیدن/نپسندیدن) آغاز می‌شود. | ||
| 186 | 186 | 3. این نظرسنجی به مدت **دو هفته** باز می‌ماند. در پایان این بازه، مجموع آرای موافق و مخالف به‌عنوان مبنای تصمیم‌گیری درباره‌ی اعمال یا رد تغییر در مستندات در نظر گرفته می‌شود. | |
| 187 | 187 | 4. اگر پیشنهاد تغییر رأی موافق کسب نکند، همان پیشنهاد را می‌توان پس از گذشت **چهار هفته** دوباره به رأی گذاشت. | |
| 188 | - 5. اگر پیشنهاد تغییر رأی موافق کسب کند، به یک ایشیوی اصلی (master issue) که فهرست کارها و تغییرات قابل‌انجام را پیگیری می‌کند اضافه خواهد شد تا هر مشارکت‌کننده‌ای که مایل باشد بتواند اجرای آن را بر عهده بگیرد. | ||
| 188 | + 5. اگر پیشنهاد تغییر رأی موافق کسب کند، به یک ایشوی اصلی (master issue) که فهرست کارها و تغییرات قابل‌انجام را پیگیری می‌کند اضافه خواهد شد تا هر مشارکت‌کننده‌ای که مایل باشد بتواند اجرای آن را بر عهده بگیرد. | ||
| 189 | 189 | ||
| 190 | 190 | ## افزودن واژه یا اصطلاح جدید به واژه‌نامه | |
| 191 | 191 | ||
| 192 | - اگر واژه یا اصطلاحی در واژه‌نامه‌ی پروژه وجود ندارد و می‌خواهید معادل پیشنهادی برای آن اضافه شود، یک ایشیو با قالب **«پیشنهاد تغییرات در ترجمه»** باز کنید و واژه‌ی انگلیسی، معادل پیشنهادی، و دلیل انتخاب آن را توضیح دهید. | ||
| 192 | + اگر واژه یا اصطلاحی در واژه‌نامه‌ی پروژه وجود ندارد و می‌خواهید معادل پیشنهادی برای آن اضافه شود، یک ایشو با قالب **«پیشنهاد تغییرات در ترجمه»** باز کنید و واژه‌ی انگلیسی، معادل پیشنهادی، و دلیل انتخاب آن را توضیح دهید. | ||
| 193 | 193 | ||
| 194 | 194 | پیشنهادهای افزودن واژه‌ی جدید نیز پس از بررسی اولیه‌ی نگهدارندگان، در صورت نیاز از همان فرایند نظرسنجی توضیح داده شده در بالا استفاده خواهند کرد تا درباره‌ی پذیرش یا رد آن تصمیم‌گیری شود. | |
| 195 | 195 | ||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -18,7 +18,7 @@ | |||
| 18 | 18 | ||
| 19 | 19 | پیش از شروع، حتماً نگاهی به این پرونده‌ها بیندازید: | |
| 20 | 20 | ||
| 21 | - - [CONTRIBUTING.md](CONTRIBUTING.md) — راهنمای کامل مشارکت: انواع ایشیو، نکات نگارشی و تایپوگرافی فارسی، سطح رسمیت و لحن نوشتار، اندازه‌ی پول‌ریکوئست، فرایند بازبینی و تأیید پول‌ریکوئست، همگام‌سازی با نسخه‌های جدید پایتون (`scripts/update_python_version.py`)، پاک‌سازی رشته‌های `fuzzy` و نگهداری اعتبار مترجمان در سرآیند پرونده‌های `.po`. | ||
| 21 | + - [CONTRIBUTING.md](CONTRIBUTING.md) — راهنمای کامل مشارکت: انواع ایشو، نکات نگارشی و تایپوگرافی فارسی، سطح رسمیت و لحن نوشتار، اندازه‌ی پول‌ریکوئست، فرایند بازبینی و تأیید پول‌ریکوئست، همگام‌سازی با نسخه‌های جدید پایتون (`scripts/update_python_version.py`)، پاک‌سازی رشته‌های `fuzzy` و نگهداری اعتبار مترجمان در سرآیند پرونده‌های `.po`. | ||
| 22 | 22 | ||
| 23 | 23 | - [واژه‌یاب](http://python.github.io/python-docs-fa/glossary-searcher) — ابزار جست‌وجوی واژگان تخصصی مستندات پایتون؛ هنگام ترجمه می‌توانید از آن برای یافتن معادل‌های فارسی ثبت‌شده و مشاهده‌ی نمونه‌های کاربرد واژگان در پیکره‌ی مستندات استفاده کنید. | |
| 24 | 24 | ||
0 commit comments