python · sepehr-rs · Sep 16, 2026 · Aug 26, 2026 · Aug 27, 2026 · Sep 5, 2026
diff --git a/.github/ISSUE_TEMPLATE/page_request.md b/.github/ISSUE_TEMPLATE/page_request.md
diff --git a/.github/ISSUE_TEMPLATE/question.md b/.github/ISSUE_TEMPLATE/question.md
diff --git a/.github/ISSUE_TEMPLATE/suggestion.md b/.github/ISSUE_TEMPLATE/suggestion.md
@@ -0,0 +1,34 @@
+---
+name: پیشنهاد تغییرات در ترجمه
+about: پیشنهاد تغییر در ترجمه‌ی یک واژه یا یک شیوه‌ی نگارشی ثابت‌شده
+title: ""
+labels: suggestion
+assignees: ''
+---
+
+## واژه یا شیوه‌ی نگارش فعلی
+
+<!-- واژه، اصطلاح یا قاعده‌ی نگارشیِ فعلی که می‌خواهید تغییر کند (در صورت وجود، ارجاع به GLOSSARY.md یا نمونه‌ای از STYLEGUIDE) -->
+
+## تغییر پیشنهادی
+
+<!-- ترجمه یا شیوه‌ی نگارشی جدیدی که پیشنهاد می‌کنید -->
+
+## دلیل پیشنهاد
+
+<!-- چرا ترجمه یا شیوه‌ی فعلی را مناسب نمی‌دانید و چرا پیشنهاد جدید بهتر است -->
+
+## نمونه‌ها / منابع
+
+<!-- در صورت وجود، لینک مستندات مرجع، نمونه‌ی استفاده در متن‌های دیگر، یا مثال‌هایی که از تغییر پشتیبانی می‌کنند -->
+
+## فرایند بررسی
+
+<!-- این بخش را خالی نگذارید و پیش از ارسال ایشیو مطالعه کنید -->
+
+- [ ] می‌دانم که پس از تأیید اولیه‌ی نگهدارندگان، نظرسنجی هم‌زمانی در گروه تلگرام و در همین ایشیو (با گزینه‌های پسندیدن/نپسندیدن) به مدت **دو هفته** برگزار می‌شود و نتیجه بر اساس مجموع آرا مشخص خواهد شد.
+- [ ] می‌دانم در صورت رأی نیاوردن، می‌توانم پس از **چهار هفته** دوباره همین پیشنهاد را به رأی بگذارم.
+
+## آیین‌نامه رفتاری
+
+- [ ] می‌پذیرم که از [آیین‌نامه‌ی رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
diff --git a/.github/ISSUE_TEMPLATE/translation_bug.md b/.github/ISSUE_TEMPLATE/translation_bug.md
@@ -6,32 +6,32 @@ labels: bug
 assignees: ''
 ---
 
-## صفحه / فایل
+## صفحه / پرونده
 
-<!-- مسیر فایل .po یا لینک صفحهٔ فارسی -->
+<!-- مسیر پرونده .po یا لینک صفحه‌ی فارسی -->
 
 ## متن اصلی (msgid)
 
 ```
 
 ```
 
-## ترجمهٔ فعلی (msgstr)
+## ترجمه‌ی فعلی (msgstr)
 
 ```
 
 ```
 
-## ترجمهٔ پیشنهادی
+## ترجمه‌ی پیشنهادی
 
 ```
 
 ```
 
 ## دلیل / توضیح
 
-<!-- چرا ترجمهٔ فعلی نادرست است؟ در صورت امکان به واژه‌نامه یا منبع معتبر ارجاع دهید. -->
+<!-- چرا ترجمه‌ی فعلی نادرست است؟ در صورت امکان به واژه‌نامه یا منبع معتبر ارجاع دهید. -->
 
 ## آیین‌نامه رفتاری
 
-- [ ] می‌پذیرم که از [آیین‌نامهٔ رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
+- [ ] می‌پذیرم که از [آیین‌نامه‌ی رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -2,9 +2,9 @@
 
 <!-- خلاصهای از ترجمه یا تغییری که انجام دادهاید بنویسید. -->
 
-## فایل‌های تغییر یافته
+## پرونده‌های تغییر یافته
 
-<!-- فایل‌های .po که ترجمه/ویرایش شده‌اند را فهرست کنید، مثلاً:
+<!-- پرونده‌های .po که ترجمه/ویرایش شده‌اند را فهرست کنید، مثلاً:
 - `library/functions.po`
 - `tutorial/controlflow.po`
 -->
@@ -15,11 +15,11 @@
 
 ## چک‌لیست
 <!-- در هر براکتی که انجام شده، یک x قرار دهید.-->
-- [ ] می‌پذیرم که از [آیین‌نامهٔ رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
-- [ ] `msgfmt --check` روی فایل‌های تغییر یافته با موفقیت اجرا شده است
-- [ ] `python3 scripts/check_markup.py` روی فایل‌های تغییر یافته اجرا شده است
+- [ ] می‌پذیرم که از [آیین‌نامه‌ی رفتاری PSF](https://www.python.org/psf/conduct/) پیروی کنم.
+- [ ] `msgfmt --check` روی پرونده‌های تغییر یافته با موفقیت اجرا شده است
+- [ ] `python3 scripts/check_markup.py` روی پرونده‌های تغییر یافته اجرا شده است
 - [ ] نشانه‌گذاری‌های Sphinx (`:class:`، `:func:`، کد درون‌خطی) و جای‌گذارها (`%s`، `{name}`) دست‌نخورده مانده‌اند
 - [ ] ترجمه‌ها با [واژه‌نامه (GLOSSARY.md)](https://github.com/python/python-docs-fa/blob/3.14/GLOSSARY.md) هماهنگ است
 - [ ] رشته‌های `fuzzy` بررسی و در صورت لزوم بازنویسی شده‌اند
-- [ ] فایل [CONTRIBUTING.md](https://github.com/python/python-docs-fa/blob/3.14/CONTRIBUTING.md) با دقت خوانده شده است.
+- [ ] پرونده [CONTRIBUTING.md](https://github.com/python/python-docs-fa/blob/3.14/CONTRIBUTING.md) با دقت خوانده شده است.
 <!-- یادآوری: بررسی‌های خودکار (sphinx-lint ،msgfmt ،check_markup و ساخت کامل) در GitHub Actions روی پول‌ریکوئست اجرا می‌شوند. -->
diff --git a/.github/workflows/build-and-deploy.yml b/.github/workflows/build-and-deploy.yml
@@ -50,7 +50,7 @@ jobs:
         uses: sphinx-doc/github-problem-matcher@v1.1
 
       - name: Build documentation
-        run: make -e SPHINXOPTS="--color -D language='fa' -D gettext_allow_fuzzy_translations=1 --keep-going" html
+        run: make -e SPHINXOPTS="--color -D language='fa' -D gettext_allow_fuzzy_translations=1 -D suppress_warnings=misc.highlighting_failure -D html_theme_options.is_rtl=true --keep-going" html
         working-directory: ./Doc
 
       - name: Setup Pages

diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -5,42 +5,20 @@ build:
   tools:
     python: "3.12"
   commands:
-    - |
-      set +e
-      if git rev-parse --verify -q HEAD^ >/dev/null; then
-        CHANGED_FILES=$(git diff --name-only HEAD^ HEAD)
-      else
-        CHANGED_FILES=""
-      fi
-      echo "Changed files: $CHANGED_FILES"
-
-      SKIP=1
-      for f in $CHANGED_FILES; do
-        case "$f" in
-          *.po|*.yaml|*.yml)
-            SKIP=0
-            ;;
-        esac
-      done
-
-      if [ -n "$CHANGED_FILES" ] && [ "$SKIP" -eq 1 ]; then
-        echo "No documentation-relevant files changed, skipping build."
-        exit 183
-      fi
-      echo "Continuing build."
-      exit 0
     - git clone --depth 1 --branch v3.14.7 https://github.com/python/cpython venv/cpython
     - pip install -r venv/cpython/Doc/requirements.txt
     - mkdir -p venv/cpython/Doc/locales/fa/LC_MESSAGES
     - cp --parents *.po venv/cpython/Doc/locales/fa/LC_MESSAGES/
     - find */ -name "*.po" -not -path "venv/*" | xargs -I{} cp --parents {} venv/cpython/Doc/locales/fa/LC_MESSAGES/
     - find venv/cpython/Doc/locales/fa/LC_MESSAGES -name "*.po" | python3 scripts/compile_mo.py
     - python -m sphinx -T -j auto -b html
+        --color
         -d $READTHEDOCS_OUTPUT/doctrees
         -D language=fa
-        -D locale_dirs=locales
-        -D gettext_compact=0
         -D gettext_allow_fuzzy_translations=1
-        -D html_theme_options.is_rtl=1
+        -D suppress_warnings=misc.highlighting_failure
+        -D gettext_compact=0
+        -D html_theme_options.is_rtl=true
+        --keep-going
         venv/cpython/Doc
-        $READTHEDOCS_OUTPUT/html
+        $READTHEDOCS_OUTPUT/html