Skip to content

🌐 [translation-sync] [names] Use builtins and %run, as Python 3 and the code cells do - #177

Merged
mmcky merged 2 commits into
mainfrom
translation-sync-2026-11-02T01-11-57-pr-654
Nov 2, 2026
Merged

mmcky merged 2 commits into
mainfrom
translation-sync-2026-11-02T01-11-57-pr-654

Conversation

@mmcky

@mmcky mmcky commented Nov 2, 2026

Copy link
Copy Markdown
Contributor

Automated Translation Sync

This PR contains automated translations from QuantEcon/lecture-python-programming.

Source PR

#654 - [names] Use builtins and %run, as Python 3 and the code cells do

Files Updated

  • ✏️ lectures/names.md
  • ✏️ .translate/state/names.md.yml

Details

  • Source Language: en
  • Target Language: fa
  • Model: claude-sonnet-5

This PR was created automatically by the translation action.

@mmcky mmcky added action-translation PRs created by QuantEcon/action-translation automated Automated sync PR opened by action-translation labels Nov 2, 2026
Copilot AI balanced review requested due to automatic review settings November 2, 2026 01:12
@netlify

netlify Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for majestic-griffin-10b166 ready!

Name Link
🔨 Latest commit dda83bc
🔍 Latest deploy log https://app.netlify.com/projects/majestic-griffin-10b166/deploys/6ae7e363859a3bf6312c6c25
😎 Deploy Preview https://deploy-preview-177--majestic-griffin-10b166.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions

github-actions Bot commented Nov 2, 2026

Copy link
Copy Markdown

✅ Translation Quality Review

Verdict: PASS | Model: claude-sonnet-5 | Date: 2026-11-02
Routing: editor — terminology 8 below floor 9
Shadow gate: would NOT auto-merge (recorded only; no action taken)


📝 Translation Quality

Criterion Score
Accuracy 9/10
Fluency 8/10
Terminology 8/10
Formatting 8/10
Overall 8.4/10

Summary: ترجمه بخش‌های «Interactive Sessions» و «The builtins Namespace» از نظر دقت مفهومی قوی و قابل‌اعتماد است و ساختار MyST به‌درستی حفظ شده، اما چند مشکل جزئی در فاصله‌گذاری بین متن فارسی و عناصر کد/انگلیسی و همچنین قالب‌بندی نامتعارف برخی توابع بیلت-این (مانند ()max به‌جای max()) دیده می‌شود که باید اصلاح شوند. مفاهیم فنی مربوط به فضای نام builtins و نشست‌های تعاملی به‌درستی و بدون از دست رفتن اطلاعات منتقل شده‌اند ساختار بلوک‌های کد و دستورات MyST/Markdown در هر دو بخش تغییر یافته به‌درستی حفظ شده است اصطلاحات کلیدی مانند «فضای نام»، «متصل/اتصال» و «بستار» به‌طور پیوسته و منطبق با واژه‌نامه در سراسر متن استفاده شده‌اند

Suggestions:

  • [minor · fluency] lectures/names.md — ## محیط تعاملی: برخی توابع بیلت-این مانند ()whos% و ()vars با علامت درصد یا پرانتز به شکل نامتعارف نوشته شده‌اند که با سبک معمول متن (مثل %whos و vars()) مطابقت ندارد و ممکن است خواننده را گیج کند. → %whos و vars() به ترتیب صحیح نوشته شوند، مثلاً: «از ()vars به جای...» باید به «از vars() به جای vars(__main__)» تغییر کند و «از whos% استفاده کنید» به «از %whos استفاده کنید» تغییر یابد.
  • [minor · fluency] lectures/names.md — ## فضای نام داخلی (The __builtins__ Namespace ): در جمله «ما از توابع داخلی مختلفی مانند ()max و ()dir و ()strو ()list و ()len و ()range و ()typeو غیره، استفاده کرده‌ایم» نحوه نوشتن توابع با پرانتز قبل از نام (()max) برخلاف قرارداد متعارف پایتون (max()) است و همچنین فاصله‌گذاری نامنظم قبل از «و» دیده می‌شود (مثلاً «()strو»). → اصلاح به: «ما از توابع داخلی مختلفی مانند max()، dir()، str()، list()، len()، range()، type() و غیره استفاده کرده‌ایم.»
  • [minor · fluency] lectures/names.md — ## محیط تعاملی: عبارت «می‌توانیم مقدار __name__را درprompt چاپ کنیم» فاقد فاصله‌ی مناسب بین کلمات فارسی و انگلیسی است (مثل «__name__را» و «درprompt») که خوانایی را کاهش می‌دهد. → اصلاح به: «می‌توانیم مقدار __name__ را در prompt چاپ کنیم»
  • [nit · terminology] lectures/names.md — ## فضای نام داخلی (The __builtins__ Namespace ): عنوان فصل به صورت ترکیبی فارسی-انگلیسی نوشته شده «فضای نام داخلی (The __builtins__ Namespace )» که با فاصله اضافی قبل از پرانتز بسته همراه است؛ این مورد جزئی است اما یکدستی ظاهری را کاهش می‌دهد. → فاصله اضافی قبل از پرانتز بسته حذف شود: «فضای نام داخلی (The __builtins__ Namespace)»

🔍 Diff Quality

Check Status
Scope Correct ✅
Position Correct ✅
Structure Preserved ✅
Heading-map Correct ✅
Overall 10/10

Summary: The two source changes (run → %run command, and builtin module description) were correctly applied in matching positions within the target document without affecting headings or metadata.


This review was generated automatically by action-translation review mode.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The automated Persian translation sync accurately matches the Python 3 source changes with verified correct %run and builtins terminology and consistent metadata, leaving no outstanding issues.

No open issues 🎉

What changed in this PR

This PR is an automated translation sync that updates the Persian (fa) translation of the names.md lecture to match upstream source PR #654 from QuantEcon/lecture-python-programming. It brings the translated prose in line with Python 3 conventions already used in the lecture's code cells, replacing the Python 2 __builtin__ module reference with builtins and correcting the IPython run command to %run.

Changes:

  • Updated the Persian text to reference the %run IPython magic command (instead of run).
  • Updated the Persian text to describe the builtins module (instead of the Python 2 __builtin__ module).
  • Refreshed translation state metadata (source SHA, sync date, model, mode UPDATE, tool version).
File Description
lectures/​names.md Corrects %run and builtins terminology in the Persian translation to match the Python 3 code cells and the upstream source.
.translate/​state/​names.md.yml Updates translation sync metadata to reflect the new source commit, date, model, mode, and tool version.

Review effort: Balanced

@github-actions

github-actions Bot commented Nov 2, 2026

Copy link
Copy Markdown

@github-actions
github-actions Bot temporarily deployed to pull request November 2, 2026 01:16 Inactive
@mmcky
mmcky merged commit cb28e56 into main Nov 2, 2026
9 of 10 checks passed
@mmcky
mmcky deleted the translation-sync-2026-11-02T01-11-57-pr-654 branch November 2, 2026 01:17

This branch was previously deployed

1 inactive deployment
pull request — dda83bc9 Deployed Nov 2, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action-translation PRs created by QuantEcon/action-translation automated Automated sync PR opened by action-translation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants