🌐 [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: zh-cn
• Model: claude-sonnet-4-6

---

This PR was created automatically by the translation action.

[github-actions]

⚠️ Translation Quality Review

Verdict: WARN | Model: claude-sonnet-4-6 | Date: 2026-03-23

---

📝 Translation Quality

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

Summary: The translation is of high quality overall, with accurate rendering of newly added sections (especially Type hints) and strong technical terminology consistency. The most critical issue is the structural duplication of the header/anchor block in the preamble, which would cause rendering problems and must be fixed. A minor accuracy issue exists in the Overview where 'type hints' is omitted from the list of topics. The translation of the new Type hints section is fluent and accurate, with only a minor quibble about 'humans' being narrowed to 'developers'. Formatting is well preserved across all changed sections. The newly added 'Type hints' section (## 类型提示) is translated with high accuracy and natural fluency, correctly rendering all subsections including the table of common types. Technical terminology is consistently and correctly handled throughout the changed sections: '迭代器' for iterators, '可迭代对象' for iterables, '生成器' for generators, '装饰器' for decorators, '描述符' for descriptors, '类型提示' for type hints. The * and ** operators section is well translated, correctly distinguishing '位置参数' (positional arguments) and '关键字参数' (keyword arguments), and maintaining the technical precision of the original. The generator expressions and generator functions sections read naturally in Chinese and preserve all code, comments, and MyST formatting correctly. The 'Why use type hints?' subsection (### 为什么使用类型提示？) preserves the numbered list structure and bold formatting for all four reasons accurately.

⚠️ Markdown Syntax Errors (CRITICAL)

• 🔴 Duplicate content: The preamble/frontmatter section contains duplicate entries - both '(python_advanced_features)=' anchor and the raw jupyter div/header block appear twice, followed by '# 更多语言特性' appearing twice. This structural duplication would cause rendering issues.

Suggestions:

• Overview section: '本讲涵盖了多种主题，包括迭代器、装饰器和描述符，以及生成器。' — The source also mentions 'type hints' (类型提示) in this list: 'including iterators, type hints, decorators and descriptors, and generators.' The translation omits '类型提示', which is an accuracy issue given that the Type hints section was newly added in this PR.

• Type hints section: '作为面向开发者和工具的文档使用。' — Source says 'for humans and tools', so '开发者' (developers) is narrower than 'humans'. Consider '面向人类和工具的文档' or '供人阅读和供工具使用的文档' to be more accurate.

• Hints don't enforce types: '对于 Python 初学者来说，有一点很重要' — Source says 'An important point for new Python programmers', which is accurate, but the heading translation '提示不强制类型检查' adds '检查' which is not in the source heading 'Hints don't enforce types'. Consider '提示不强制类型' to stay closer to the source.

• Iterators in for loops: The code comment in the for loop example '# do something' is left in English inside a no-execute code block. While code comments are often left untranslated, this is consistent with the source so it is acceptable, but worth noting the pattern is inconsistent — some code comments in the changed sections remain in English while explanatory text around them is translated.

---

🔍 Diff Quality

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

Summary: The heading-map is correctly updated with new Type hints entries and renamed headings, but the target document is corrupted by a duplicated anchor/header block near the top, breaking document structure and position correctness.

Issues:

• The target document 'after' version contains a duplicated header block: the (python_advanced_features)= anchor and the raw jupyter div header appear twice, followed by # 更多语言特性 appearing twice before the ## 概述 section.
• The new 'Type hints' section content is correctly added in the target, but its placement is preceded by the duplicate header issue which disrupts document structure.
• Several heading capitalizations changed in the source (e.g., 'Iterables and Iterators' → 'Iterables and iterators', 'Iterators in For Loops' → 'Iterators in for loops', etc.) and the heading-map correctly reflects these, but the duplicate header block is a structural corruption not present in the source 'after' version.
• The source 'after' removes the matplotlib i18n font setup code block that was in the translation's 'before' version — the target 'after' also correctly removes it, which is appropriate.
• The (iterators)= and (descriptors)= and (paf_generators)= anchors in the target 'after' have an extra blank line inserted after them before the heading, which differs from the source pattern.

---

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

[mmcky]

@HumphreyYang same with this PR