Repository navigation
🌐 [translation-sync] [ak2, ak_aiyagari, two_computation] Correct math and economics, add exercises - #290
Merged
Conversation
mmcky
added
action-translation
✅ Deploy Preview for astonishing-narwhal-a8fc64 ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Translation Quality ReviewVerdict: PASS | Model: claude-sonnet-5 | Date: 2026-10-09 📝 Translation Quality
Summary: 三篇讲义的翻译整体质量很高，专业术语与经济学概念翻译准确，格式和代码、公式保留完好，未发现语法错误。个别地方存在半角标点残留和部分直译导致的轻微生硬感，建议统一标点符号并润色个别长句，使行文更符合中文学术写作习惯。 专业术语翻译准确，且与术语表高度一致，如“世代交叠模型”“稳态”“打靶法”“风险敏感性”等关键概念保持统一 数学公式、代码块及MyST/Jupyter指令格式完整保留，未出现编号或语法错误 长难句的逻辑结构处理得当，保持了原文的严谨性和学术语气，尤其是对蒙特卡洛模拟与倒推法等算法描述的翻译清晰准确 Suggestions:
🔍 Diff Quality
Summary: The translation sync correctly mirrors the English source changes across all three files, with matching section positions, preserved structure, and properly updated heading-map entries reflecting renamed headings. This review was generated automatically by action-translation review mode. |
There was a problem hiding this comment.
🔵 Needs a closer look
It is a large translation sync with substantial new math, economics, and executable exercise code that cannot be run/verified here, so it warrants human review despite only minor consistency issues being found.
4 open findings
What changed in this PR
This is an automated translation-sync PR that updates the Chinese (zh-cn) editions of three QuantEcon lectures — ak2.md, ak_aiyagari.md, and two_computation.md — to mirror upstream source PR lecture-python.myst#1078. The changes port corrected math/economics, refactored code, and newly added "练习" (Exercises) and "结束语" (Concluding remarks) sections into the translated editions, and bump the corresponding .translate/state/*.yml sync metadata.
Changes:
- Translates new Exercises/Concluding-remarks sections and corrects economic exposition (e.g., MPK fix
r_t = αK^{α-1}L^{1-α}inak2.md, debt timingD_{t+1}, per-capita resource constraint and notation table intwo_computation.md). - Refactors embedded code: adds
max_iterguards and an iteration-count return tofind_ss/path_iterationinak_aiyagari.md(callers verified unaffected), simplifies_compute_compensationintwo_computation.md(removed variables confirmed unused). - Adds figure captions/names and adjusts Matplotlib labels; updates sync state metadata.
| File | Description |
|---|---|
lectures/ak2.md |
Translates Overview + 3 new exercises; math corrections; introduces a C_{ot+1} notation typo in the Lagrangian |
lectures/ak_aiyagari.md |
Translates text + 3 new exercises; safe find_ss/path_iteration refactor; inconsistent "实验一/实验2" heading numbering and two untranslated figure captions |
lectures/two_computation.md |
Adds notation table, exercises, concluding remarks; clean code refactor; several plot axis labels reverted from Chinese to English |
.translate/state/ak2.md.yml |
Sync metadata bump (source-sha, mode UPDATE, tool-version) |
.translate/state/ak_aiyagari.md.yml |
Sync metadata bump |
.translate/state/two_computation.md.yml |
Sync metadata bump (model, section-count, tool-version) |
🧠 Review effort: Balanced
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
| $$ | ||
| \begin{aligned} | ||
| {\mathcal L} & = C_{yt}^\beta C_{o,t+1}^{1-\beta} \\ & + \lambda \Bigl[ C_{yt} + \frac{C_{o,t+1}}{1 + r_{t+1}(1 - \tau_{t+1})} - W_t (1 - \tau_t) + \delta_{yt} + \frac{\delta_{ot}}{1 + r_{t+1}(1 - \tau_{t+1})}\Bigr], | ||
| {\mathcal L} & = C_{yt}^\beta C_{o,t+1}^{1-\beta} \\ & + \lambda \Bigl[ W_t (1 - \tau_t) - \delta_{yt} - \frac{\delta_{o,t+1}}{1 + r_{t+1}(1 - \tau_{t+1})} - C_{yt} - \frac{C_{ot+1}}{1 + r_{t+1}(1 - \tau_{t+1})} \Bigr], |
| Transition dynamics: 转换动态 | ||
| 'Experiment 1: Immediate tax cut': 实验1：即时减税 | ||
| 'Experiment 2: Preannounced tax cut': 实验2：预先宣布的减税 | ||
| 'Experiment 1: an immediate tax cut': 实验一：立即减税 |
| --- | ||
| mystnb: | ||
| figure: | ||
| caption: Change in mean consumption by age |
Comment on lines
+385
to
+386
| ax.set_ylabel("date born") | ||
| ax.set_xlabel("time") |
mmcky
added a commit
that referenced
this pull request
Oct 18, 2026
…gari's household rename, add the programming intersphinx key (#297) * ak_aiyagari: finish the hh → household rename in the six cells the 2026-08-05 sync never delivered myst#706 renamed the household parameter from hh to household on 2026-08-05. Its sync run failed before it could file anything (the anthropic-api-key input was missing that night), so the rename never reached this edition. Today's #290 then synced myst#1078's cells, which use the new name, on top of the old one, and the lecture stopped executing. This brings the nine remaining code lines into line with the English; the lecture's code now has the same 56 hh and the same call sites as the source. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * _config: map the programming intersphinx key to the zh-cn programming edition linear_algebra (#280, synced from myst#1054) now carries four {doc}/{ref} targets under the programming: key the English config defines. This edition only had pyprog:, so the build reported four unknown-document warnings, which -W turns into a failure. The zh-cn programming site carries the three labels (numpy_array, numpy_shape_dim, creating_arrays), so the key points there. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * environment: install jax 0.11.0, since two lectures skip their own install cell Every other JAX lecture in this edition installs JAX at run time through a !pip install cell that executes. ak_aiyagari and two_computation carry that cell tagged skip-execution, as the English does, because the English runner preinstalls jax[cuda13]. This CI preinstalled nothing, so both lectures failed on import jax. Pinned at 0.11.0 for the lax.fori_loop regression in 0.11.1 (QuantEcon/workspace-lectures#49); the unpinned install cells then leave it in place. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
This branch was previously deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Automated Translation Sync
This PR contains automated translations from QuantEcon/lecture-python.myst.
Source PR
#1078 - [ak2, ak_aiyagari, two_computation] Correct math and economics, add exercises
Files Updated
lectures/ak2.md.translate/state/ak2.md.ymllectures/ak_aiyagari.md.translate/state/ak_aiyagari.md.ymllectures/two_computation.md.translate/state/two_computation.md.ymlThe following sections exist in the current translation but have no counterpart in the source document, so this sync removes them (the translation mirrors the source's structure). If the source deleted these sections, this removal is correct — merge as usual. If they are human-authored additions you want to keep, move them into a target-only file before merging (see adding content to a translated edition).
lectures/ak2.md:引言,均衡lectures/ak_aiyagari.md:实验1：即时减税,实验2：预先宣布的减税Details
This PR was created automatically by the translation action.