🌐 [translation-sync] Add Type Hints section to More Language Features lecture

[mmcky]

Automated Translation Sync

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

Source PR

#488 - Add Type Hints section to More Language Features lecture

Files Updated

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

Details

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

---

This PR was created automatically by the translation action.

[netlify]

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

Name	Link
🔨 Latest commit	3af2a73
🔍 Latest deploy log	https://app.netlify.com/projects/majestic-griffin-10b166/deploys/69c215bf2a4f1a0008f71d72
😎 Deploy Preview	https://deploy-preview-73--majestic-griffin-10b166.netlify.app
📱 Preview on mobile	Toggle 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]

✅ Translation Quality Review

Verdict: PASS | Model: claude-sonnet-4-6 | Date: 2026-03-24

---

📝 Translation Quality

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

Summary: This is a high-quality translation of a technical Python programming lecture. The newly added 'Type hints' section is accurately and fluently translated. Technical terms are handled consistently, formatting is well-preserved, and no syntax errors were found. Minor issues include the omission of a specific example (VS Code) in the type hints section and a slightly awkward heading translation for 'Enter decorators'. Overall the translation is accurate, readable, and suitable for a Persian-speaking technical audience. Technical Python terms (iterator, iterable, generator, decorator, descriptor, type hints) are consistently kept in English with Persian plural/grammatical suffixes, following standard practice in Persian technical writing. The newly added 'Type hints' section is well-translated with accurate explanations of runtime behavior, editor support, and the distinction from statically typed languages. Mathematical and code content is fully preserved without modification, and all MyST directives, code-cell blocks, and formatting elements are correctly maintained. The heading-map in the YAML frontmatter is comprehensive and accurately maps all section and subsection titles to their Persian equivalents. The translation maintains a consistent academic register throughout, with natural Persian sentence flow and appropriate use of technical terminology.

Suggestions:

• Type hints → 'راهنمای نوع': The term 'type hints' is translated as 'راهنمای نوع' throughout, which is acceptable but 'نشانه‌گذاری نوع' or 'اشاره‌های نوع' may be more widely recognized in Persian technical writing. However, since this is applied consistently, it is not a critical issue.

• Why use type hints? → Item 2 'Editor support': 'محیط‌های توسعه یکپارچه' is a correct translation of 'IDEs' but the original says 'IDEs like VS Code' — the translation omits the specific example 'VS Code' and replaces it with a generic phrase. Suggestion: keep 'محیط‌های توسعه یکپارچه مانند VS Code' to preserve the specific example.

• Iterators in for loops: The translation of 'binds x to the result' as 'x را به نتیجه متصل می‌کند' is accurate, but 'اتصال' for 'bind' in Python context could be more precisely rendered as 'مقید می‌کند' or 'نسبت می‌دهد' to better reflect the Python name-binding concept used throughout the section.

• Decorators and descriptors → '#### Enter decorators': The heading 'Decoratorها وارد می‌شوند' is a literal and somewhat awkward translation of 'Enter decorators'. A more natural Persian phrasing would be 'معرفی Decoratorها' or 'آشنایی با Decoratorها'.

---

🔍 Diff Quality

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

Summary: The translation sync is correctly implemented: the new 'Type hints' section is inserted in the correct position between the */** operators section and Decorators, all heading-map keys are updated to reflect the lowercased English headings from the source, new heading-map entries for the Type hints subsections are added, and the Persian translations of headings and body text are consistent with the document structure.

---

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

[github-actions]

🚀 Deployed on https://69c2172339fb227116c2d2e9--majestic-griffin-10b166.netlify.app