🌐 [translation-sync] Add Type Hints section to More Language Features lecture#70
🌐 [translation-sync] Add Type Hints section to More Language Features lecture#70
Conversation
✅ Deploy Preview for majestic-griffin-10b166 ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
❌ Translation Quality ReviewVerdict: FAIL | Model: claude-sonnet-4-6 | Date: 2026-03-24 📝 Translation Quality
Summary: The translation has critical structural failures: the entire newly added 'Type hints' section (6 subsections) is completely absent from the document body, and the Generators section is duplicated/mislabeled due to incorrect section heading under the (paf_generators)= anchor. The heading-map also contains incorrect mappings for the Type hints section. The portions that are translated (iterators, operators, decorators) are reasonably fluent and accurate, but the missing Type hints content and structural duplication/mislabeling of Generators are severe issues that must be fixed before this translation can be considered acceptable. The translated sections that are present (Iterables and iterators, * and ** operators, Decorators and descriptors, Generators) are generally accurate and fluent in Persian Technical terms like iterator, generator, decorator, descriptor are consistently kept in English with Persian pluralization (e.g., iteratorها, generatorها) Code blocks and MyST directives are properly preserved throughout the translated content that exists Mathematical and programming concepts are explained clearly in the Persian text where content is present
|
| Check | Status |
|---|---|
| Scope Correct | ✅ |
| Position Correct | ❌ |
| Structure Preserved | ❌ |
| Heading-map Correct | ❌ |
| Overall | 2.5/10 |
Summary: The translation sync failed: the new 'Type hints' section body content is missing from the translation, the document structure is broken with duplicated 'Decorators and Descriptors' content after the (paf_generators)= anchor, and the heading-map entries for 'Type hints' use incorrect translations recycled from other sections.
Issues:
- The new 'Type hints' section from the English source is missing in the translated document body — no Persian translation of the Type hints content was inserted
- The (paf_generators)= anchor is followed by a duplicate '## Decoratorها و Descriptorها' section instead of '## Generatorها', causing the Generators section to appear duplicated
- The heading-map maps 'Type hints' to 'Decoratorها و Descriptorها' which is incorrect — it reuses the translation for 'Decorators and Descriptors'
- The heading-map maps 'Type hints::Basic syntax' to 'Decoratorها' and 'Type hints::Common types' to 'Descriptorها', both of which are wrong translations
- Several subsections of Type hints are missing from the heading-map: 'Hints don't enforce types', 'Why use type hints?', 'Type hints in scientific Python'
This review was generated automatically by action-translation review mode.
❌ Translation Quality ReviewVerdict: FAIL | Model: claude-sonnet-4-6 | Date: 2026-03-24 📝 Translation Quality
Summary: The translation has critical structural problems. The entire newly added 'Type hints' section (with 5 subsections) is completely absent from the translation body, which is a major omission for an ADDED section in this PR. Furthermore, the content following the '(paf_generators)=' anchor incorrectly duplicates the 'Decorators and descriptors' section instead of rendering the 'Generators' section — this appears to be a copy-paste error causing the Generators section to be buried under incorrect headings. The heading-map also contains wrong mappings for Type hints entries. The sections that are correctly translated show good quality, but the structural and completeness errors make this translation unsuitable for publication without significant revision. The translated sections that are correctly rendered (Iterables and iterators, * and ** operators, Decorators and descriptors first occurrence, Generators) show good fluency and natural Persian phrasing. Technical terms like 'iterator', 'decorator', 'descriptor', 'generator' are handled consistently with appropriate Persian pluralization conventions (e.g., 'Iteratorها', 'Generatorها'). Code blocks, mathematical expressions, and MyST directives are correctly preserved in sections that were properly translated. The translation of procedural explanations (e.g., the check_nonneg decorator example walkthrough) is clear and accurate where present.
|
| Check | Status |
|---|---|
| Scope Correct | ✅ |
| Position Correct | ❌ |
| Structure Preserved | ❌ |
| Heading-map Correct | ❌ |
| Overall | 2.5/10 |
Summary: The target document has critical structural corruption: the new 'Type hints' section is missing from the body entirely, its heading-map entries have wrong Persian values, and a duplicate 'Decorators and Descriptors' block was inserted where the 'Generators' section should follow the (paf_generators)= anchor.
Issues:
- The new 'Type hints' section content was NOT inserted into the target document body — instead, the existing 'Decorators and Descriptors' section content was duplicated after the (paf_generators)= anchor, creating a doubled/corrupted section where 'Generators' content should be.
- After (paf_generators)=, the target body shows '## Decoratorها و Descriptorها' again instead of '## Generatorها', meaning the Generators section heading and its unique content were replaced/overwritten by a duplicate of Decorators and Descriptors.
- The heading-map entry for 'Type hints' maps to 'Decoratorها و Descriptorها' (the Persian for Decorators and Descriptors), which is incorrect — it should map to a Persian translation of 'Type hints' (e.g., 'نکات نوع' or 'راهنماییهای نوع').
- The heading-map entries for 'Type hints::Basic syntax' and 'Type hints::Common types' map to 'Decoratorها' and 'Descriptorها' respectively, which are wrong translations — these should map to Persian translations of 'Basic syntax' and 'Common types'.
- The entire 'Type hints' section body (including its subsections Basic syntax, Common types, Hints don't enforce types, Why use type hints, Type hints in scientific Python) is absent from the translated document body — no Persian translation or even placeholder was added.
- The 'Generators' section in the target after document body appears twice: first correctly, then duplicated as part of the corrupted insertion, causing structural corruption.
- The heading-map keys were updated to lowercase variants (e.g., 'Iterables and iterators', 'Decorators and descriptors') matching the source changes, but the body headings in the Persian translation were NOT updated to match — the body still uses the old-cased headings like '## Iterableها و Iteratorها' and '### Iteratorها در حلقههای For', creating a mismatch between heading-map keys and actual rendered headings.
This review was generated automatically by action-translation review mode.
1 participant
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.ymlDetails
This PR was created automatically by the translation action.