Skip to content

🌐 [translation-sync] Misc changes to jax lectures#110

Open
mmcky wants to merge 4 commits intomainfrom
translation-sync-2026-04-14T20-37-32-pr-533
Open

🌐 [translation-sync] Misc changes to jax lectures#110
mmcky wants to merge 4 commits intomainfrom
translation-sync-2026-04-14T20-37-32-pr-533

Conversation

@mmcky
Copy link
Copy Markdown
Contributor

@mmcky mmcky commented Apr 14, 2026

Automated Translation Sync

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

Source PR

#533 - Misc changes to jax lectures

Files Updated

  • ✏️ lectures/jax_intro.md
  • ✏️ .translate/state/jax_intro.md.yml
  • ✏️ lectures/numpy_vs_numba_vs_jax.md
  • ✏️ .translate/state/numpy_vs_numba_vs_jax.md.yml

Details

  • Source Language: en
  • Target Language: fa
  • Model: claude-sonnet-4-6

This PR was created automatically by the translation action.

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 14, 2026

Deploy Preview for majestic-griffin-10b166 ready!

Name Link
🔨 Latest commit c93c8ba
🔍 Latest deploy log https://app.netlify.com/projects/majestic-griffin-10b166/deploys/69dea593d740940008a23189
😎 Deploy Preview https://deploy-preview-110--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
Copy link
Copy Markdown

github-actions bot commented Apr 14, 2026

✅ Translation Quality Review

Verdict: PASS | Model: claude-sonnet-4-6 | Date: 2026-04-14


📝 Translation Quality

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

Summary: The Persian translation of the modified sections is of high quality overall. Accuracy, fluency, and terminology are strong, with correct use of established technical vocabulary and consistent treatment of key concepts. The formatting is well-preserved with no syntax errors. Minor issues include one sentence fragment in the 'Benefits' bullet list, a slightly misleading word choice for 'memory intensive' in the 'Memory Issues' section, and a mildly awkward opening phrase in 'Overall recommendations'. These are minor and do not significantly impair comprehension. Technical terminology is consistently and accurately rendered throughout all modified sections, including correct translations of 'pure functions' (توابع خالص), 'side effects' (عوارض جانبی), 'immutable' (تغییرناپذیر), and 'vectorization' (برداری‌سازی) in line with the reference glossary. The newly added 'Examples -- Pure and Impure' section is well-translated with clear Persian explanations of why the impure function fails to be pure, preserving the pedagogical intent of the original. Mathematical formatting, code blocks, MyST directives, and LaTeX equations are all preserved correctly across all modified sections with no syntax errors. The translation maintains appropriate academic register throughout, and complex sentences in the 'Benefits', 'JAX', and 'Overall recommendations' sections are rendered naturally in Persian without awkward calques from English. The 'Summary' sections in both documents accurately convey the comparative conclusions between NumPy, Numba, and JAX, preserving the nuanced trade-off discussion of the original.

Suggestions:

  • Examples -- Pure and Impure section: 'این تابع نمی‌تواند خالص باشد زیرا' → 'این تابع خالص نیست زیرا' — The original says 'This function fails to be pure because' which is better rendered as a direct statement of fact rather than implying incapability.

  • Benefits section: 'کنترل آنچه در رشته‌های جداگانه اتفاق می‌افتد' is a sentence fragment (missing verb) in the bullet list → should be 'کنترل آنچه در رشته‌های جداگانه اتفاق می‌افتد امکان‌پذیر است' or restructured as 'امکان کنترل اجرا در رشته‌های موازی' to match the parallelism of the other bullet points.

  • Memory Issues section: 'شبکه‌های mesh دوبعدی هستند و از این رو بسیار فشرده از نظر حافظه' → 'شبکه‌های mesh دوبعدی هستند و از این رو بسیار پرمصرف از نظر حافظه' — 'memory intensive' means high memory consumption, not 'compressed/dense' (فشرده); 'پرمصرف' or 'حافظه‌بر' is more accurate.

  • Summary (vectorized ops) section: 'هم از نظر سرعت ... و هم از نظر کارایی حافظه ... بر NumPy غلبه می‌کند' — the original says 'It dominates NumPy both in terms of speed ... and memory efficiency' which is correctly translated, but the following sentence 'همچنین هنگام اجرا روی GPU بر Numba غلبه می‌کند' omits the nuance of 'also dominates Numba when run on the GPU' implying CPU comparison may differ; the translation is acceptable but could add 'در مقایسه با اجرای روی CPU' for completeness.

  • Overall recommendations section: 'حال قدمی به عقب بر می‌داریم' → 'حال یک قدم به عقب برمی‌گردیم' — 'قدمی به عقب بر می‌داریم' is an awkward construction; 'یک قدم عقب می‌رویم و' or 'با نگاهی کلی،' would be more natural Persian.


🔍 Diff Quality

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

Summary: All translation changes are correctly positioned, scoped, structured, and reflected in the heading metadata for both modified files.


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

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Automated translation sync updating the Persian (fa) versions of the JAX-related lectures to match upstream content changes from QuantEcon/lecture-python-programming.

Changes:

  • Updated lecture structure/headings and expanded explanations/examples in jax_intro.md (functional programming, RNG model, and JIT discussion).
  • Updated numpy_vs_numba_vs_jax.md with revised vectorization narrative (including a new memory-usage subsection) and reorganized JAX/Numba examples.
  • Refreshed translation sync state metadata (source-sha, synced-at) for both lectures.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
lectures/jax_intro.md Updates translated headings and revises/expands sections on pure functions, RNG, and JIT compilation.
lectures/numpy_vs_numba_vs_jax.md Adds/reshapes translated content around NumPy vectorization, memory implications, and JAX vmap/JIT examples.
.translate/state/jax_intro.md.yml Updates translation sync metadata for jax_intro.md.
.translate/state/numpy_vs_numba_vs_jax.md.yml Updates translation sync metadata for numpy_vs_numba_vs_jax.md.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@@ -188,8 +229,6 @@ grid = np.linspace(-3, 3, 3_000)
with qe.Timer():
# First run
z_max_numba = compute_max_numba(grid)
grid.nbytes
```

شبکه‌های mesh دوبعدی هستند و از این رو بسیار فشرده از نظر حافظه
@github-actions
Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants