🌐 [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: FAIL | Model: claude-sonnet-4-6 | Date: 2026-03-24

---

📝 Translation Quality

Criterion	Score
Accuracy	4/10
Fluency	7/10
Terminology	6/10
Formatting	3/10
Overall	5.1/10

Summary: The translation has critical structural failures. The entire newly ADDED 'Type hints' section is completely missing from the translation body. Additionally, the 'Decorators and descriptors' section content is duplicated — the second occurrence of (paf_generators)= anchor incorrectly renders the Decorators content again instead of the Generators section. The heading-map contains seriously incorrect entries mapping 'Type hints' headings to decorator/descriptor labels. The Overview paragraph also omits the mention of type hints. The portions that ARE correctly translated are of good quality, but the missing and duplicated sections represent critical accuracy and formatting failures that require immediate correction. The translated portions of existing sections (Iterables and iterators, * and ** operators, Decorators and descriptors, Generators) are fluent and accurate in Chinese Technical terminology within the translated sections is generally consistent and correct (e.g., 迭代器, 生成器, 装饰器, 描述符, 位置参数, 关键字参数) Code comments are appropriately translated into Chinese while preserving all code syntax intact Sentence structure reads naturally in Chinese academic style for the sections that are present

⚠️ Markdown Syntax Errors (CRITICAL)

• 🔴 Critical structural error: The entire 'Type hints' section (## Type hints, ### Basic syntax, ### Common types, ### Hints don't enforce types, ### Why use type hints?, ### Type hints in scientific Python) is completely missing from the translation body
• 🔴 The heading-map contains incorrect mappings: 'Type hints' maps to '装饰器与描述符', 'Type hints::Basic syntax' maps to '装饰器', 'Type hints::Common types' maps to '描述符' — these are wrong category mappings
• 🔴 Duplicate section error: '## 装饰器与描述符' appears twice in the document body (once correctly after the type hints location, and again after the descriptors section where '## 生成器' should appear — the anchor '(paf_generators)=' is followed by '## 装饰器与描述符' instead of '## 生成器')
• 🔴 The anchor '(paf_generators)=' appears twice in the document, both incorrectly followed by '## 装饰器与描述符' content instead of the Generators section on the second occurrence

Suggestions:

• Missing entire section: The 'Type hints' section and all its subsections (Basic syntax, Common types, Hints don't enforce types, Why use type hints?, Type hints in scientific Python) are completely absent from the translation. This is a critical omission of a newly ADDED section.
• Structural duplication: The '## 装饰器与描述符' section and all its content is duplicated verbatim. The second occurrence (after the first complete decorators/descriptors section) should instead be '## 生成器' (Generators section).
• heading-map error: 'Type hints' → '装饰器与描述符', 'Type hints::Basic syntax' → '装饰器', 'Type hints::Common types' → '描述符' are all incorrect mappings. These should map to type-hints-related Chinese translations, e.g., 'Type hints' → '类型提示'.
• Overview section omission: The translated Overview mentions '迭代器、装饰器和描述符，以及生成器' but omits '类型提示' (type hints), which is explicitly listed in the English source: 'including iterators, type hints, decorators and descriptors, and generators'.
• heading-map missing entries: The newly ADDED sections ('Type hints', 'Basic syntax', 'Common types', 'Hints don't enforce types', 'Why use type hints?', 'Type hints in scientific Python') need proper Chinese heading-map entries such as 'Type hints' → '类型提示', 'Type hints::Basic syntax' → '基本语法', etc.

---

🔍 Diff Quality

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

Summary: The target document has critical errors: the new 'Type hints' section content is missing from the body, the 'Decorators and Descriptors' section is duplicated in place of the Generators section, and the heading-map entries for 'Type hints' contain incorrect Chinese translations borrowed from other sections.

Issues:

• The target document contains a massive duplication: the entire 'Decorators and Descriptors' section (including all subsections, code cells, and the (descriptors)= anchor) is duplicated verbatim after the (paf_generators)= anchor, where the 'Generators' section should begin. This is a critical structural error.
• The new 'Type hints' section from the English source was NOT added to the Chinese translation. The body content for Type hints is entirely missing from the target document.
• The heading-map entry 'Type hints: 装饰器与描述符' is semantically wrong — 'Type hints' should map to a Chinese translation of 'Type hints' (e.g., '类型提示'), not to '装饰器与描述符' which is the translation for 'Decorators and descriptors'.
• The heading-map entries 'Type hints::Basic syntax: 装饰器' and 'Type hints::Common types: 描述符' are also semantically wrong — they map Type hints subsections to Decorators/Descriptors translations.
• The heading-map is missing entries for the new Type hints subsections that should be in the translation: 'Type hints::Hints don't enforce types', 'Type hints::Why use type hints?', 'Type hints::Type hints in scientific Python'.
• The (paf_generators)= anchor appears twice in the target document — once before the correct Generators section near the end, and once incorrectly before the duplicated Decorators and Descriptors section.
• The (descriptors)= anchor also appears twice in the target document due to the duplication.
• The source English document changed heading 'Iterables and Iterators' to lowercase 'Iterables and iterators', but the target body still uses '可迭代对象与迭代器' as the section heading (which is acceptable as a translation), however the heading-map key was updated from 'Iterables and Iterators' to 'Iterables and iterators' correctly.
• The heading-map now includes a top-level entry 'More Language Features: 更多语言特性' which was not in the before state — this addition is valid but should be verified as intentional.

---

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