Skip to content

🌐 [translation-sync] [lucas_prescott_investment, optimal_growth_uncertainty] Two sequels to rational_expectations - #286

Merged
mmcky merged 14 commits into
mainfrom
translation-sync-2026-09-27T06-05-07-pr-1070
Oct 21, 2026
Merged

mmcky merged 14 commits into
mainfrom
translation-sync-2026-09-27T06-05-07-pr-1070

Conversation

@mmcky

@mmcky mmcky commented Sep 27, 2026

Copy link
Copy Markdown
Contributor

Automated Translation Sync

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

Source PR

#1070 - [lucas_prescott_investment, optimal_growth_uncertainty] Two sequels to rational_expectations

Files Added

  • ✅ lectures/lq_mean_field_games.md
  • ✅ .translate/state/lq_mean_field_games.md.yml
  • ✅ lectures/lucas_prescott_investment.md
  • ✅ .translate/state/lucas_prescott_investment.md.yml

Files Updated

  • ✏️ lectures/rational_expectations.md
  • ✏️ .translate/state/rational_expectations.md.yml
  • ✏️ lectures/_toc.yml
  • ✏️ lectures/_static/quant-econ.bib

Details

  • Source Language: en
  • Target Language: zh-cn
  • Model: claude-sonnet-5

This PR was created automatically by the translation action.

Copilot AI lite review requested due to automatic review settings September 27, 2026 06:05
@mmcky mmcky added action-translation PRs created by QuantEcon/action-translation automated Automated sync PR opened by action-translation labels Sep 27, 2026
@netlify

netlify Bot commented Sep 27, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for astonishing-narwhal-a8fc64 ready!

Name Link
🔨 Latest commit 6c3f689
🔍 Latest deploy log https://app.netlify.com/projects/astonishing-narwhal-a8fc64/deploys/6ad94400960e899ab122729c
😎 Deploy Preview https://deploy-preview-286--astonishing-narwhal-a8fc64.netlify.app
📱 Preview on mobile
Toggle QR Code...

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

github-actions Bot commented Sep 27, 2026 •

Copy link
Copy Markdown

✅ Translation Quality Review

Verdict: PASS | Model: claude-sonnet-5 | Date: 2026-10-21
Routing: editor — 1 minor finding(s) in gating categories (accuracy/terminology/syntax/diff-check/other)
Shadow gate: would NOT auto-merge (recorded only; no action taken)


📝 Translation Quality

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

Summary: 整体翻译质量很高,准确传达了原文的经济学和数学内容,专业术语翻译规范且与术语表高度一致,MyST格式(数学公式、证明环境、代码块、交叉引用)均完整保留且未发现语法错误。仅存在少量可改进之处,如部分长句翻译稍显生硬、以及个别代码注释的翻译风格与其他章节不完全一致,但均属于轻微问题,不影响读者理解。 对里卡蒂方程、哈密顿结构、协态系统等高度专业化的数学术语翻译准确一致,符合术语表要求 长篇幅的数学推导、证明步骤与代码注释保持了与原文完全对应的结构和编号,公式引用无误 经济学专业术语(如托宾q、消费者剩余、竞争均衡、理性预期)翻译准确且与术语表保持一致 译文在复杂从句和被动语态处理上总体流畅自然,符合学术文本的中文表达习惯

Suggestions:

  • [minor · fluency] lectures/lq_mean_field_games.md — The equilibrium Riccati equation: 原文 'That equation looks forbidding, but a change of variable transforms it.' 翻译为'那个方程看起来令人望而生畏,但一个变量替换可以转化它。'略显生硬,可更自然地表达变量替换这一动作。 → 那个方程看起来令人望而生畏,但通过一次变量替换就能化简它。
  • [minor · terminology] lectures/optimal_growth_uncertainty.md — Computing the model code cells: 代码注释被翻译成了中文(如 '几何资本网格,使得 (1-δ)K 本身也是网格点。'),而其他讲座中的代码注释均保留英文原文未翻译,存在风格不一致。 → 保持与其他章节一致,将代码内注释保留为英文,或在全文中统一这一处理方式。
  • [minor · fluency] lectures/optimal_growth_uncertainty.md — Overview: 'The lecture {doc}lucas_prescott_investment studied a competitive industry...' 被翻译为 '{doc}lucas_prescott_investment 这一讲座研究了一个竞争行业...',读起来略显拗口,可调整语序使其更符合中文表达习惯。 → {doc}lucas_prescott_investment 研究了一个竞争行业,其均衡是规划问题的解,并且其均衡是具有不变分布的马尔可夫过程。
  • [nit · formatting] lectures/optimal_growth_uncertainty.md — import statements: 该讲座的导入代码块中新增了 'import matplotlib as mpl' 等字体相关的 i18n 代码,且带有英文注释 '# i18n',而其余三篇讲座中类似字体设置代码直接嵌入且不带注释,风格略有差异,但不影响理解。

🔍 Diff Quality

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

Summary: The translation sync correctly added three new target files mirroring the three new source files and updated rational_expectations.md in the same relative positions with matching structure and accurate heading maps.

Issues:

  • In lucas_prescott_investment.md and optimal_growth_uncertainty.md, the translation headings map key for 'Overview' is present but the body text actually translates 'Overview' heading text consistently with the map - verified correct, no issue
  • Minor: optimal_growth_uncertainty.md contains leftover i18n font-setup boilerplate comments (# i18n) that are a translation-workflow artifact rather than content, but this matches expected localization conventions and is not a structural issue

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

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

There is at least one confirmed typo in the updated lecture text and the ToC captions were changed to English across the zh-cn navigation, which is a user-visible language inconsistency.

Review effort: Lite
Findings: 2 Low severity

Open (2)
What changed in this PR

This PR syncs new/updated lecture translations from QuantEcon/lecture-python.myst into the zh-cn lecture set, adding two sequel lectures related to the rational expectations content and updating navigation and references accordingly.

Changes:

  • Added two new translated lectures: lucas_prescott_investment and lq_mean_field_games
  • Updated rational_expectations to reference the sequel lectures and added a concluding remarks section
  • Updated the book ToC and bibliography to include the new lectures and citation entries, plus translation state metadata updates
File Description
lectures/​rational_expectations.md Adds sequel-lecture cross-links and a new concluding remarks section; minor translation adjustments
lectures/​lucas_prescott_investment.md New translated lecture on Lucas–Prescott investment under uncertainty
lectures/​lq_mean_field_games.md New translated lecture on LQ mean field games with extensive math/code content
lectures/​_toc.yml Adds new lecture entries and updates part captions/navigation labels
lectures/​_static/​quant-econ.bib Adds bibliography entries required by the new lecture citations
.translate/​state/​rational_expectations.md.yml Updates translation sync metadata for the updated lecture
.translate/​state/​lucas_prescott_investment.md.yml Adds translation sync metadata for the new lecture
.translate/​state/​lq_mean_field_games.md.yml Adds translation sync metadata for the new lecture

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread lectures/_toc.yml Outdated
Comment on lines 4 to 5
- caption: Tools and Techniques
numbered: true

本讲座中的三个思想贯穿于整个宏观经济学。

第一个思想是均衡概念本身:对市场层面对象的*感知到的*运动规律必须与由由此产生的决策所生成的*实际*运动规律相吻合。
mmcky and others added 4 commits October 22, 2026 09:57
QuantEcon/lecture-python.myst#1070 added two lectures, but this PR
delivered only lucas_prescott_investment: optimal_growth_uncertainty
failed the structural parity check (the model dropped the leading
{raw} header block and the anchor), so its sync failure was filed as
QuantEcon/lecture-python.myst#1072 and the file never arrived. This
PR's _toc.yml and lucas_prescott_investment both point at it, so the
preview could not build.

translate init -f optimal_growth_uncertainty.md at engine v0.29.6
(@v0), claude-sonnet-5, from lecture-python.myst main (9ad04de; the
file's last change is 0abf403, the #1070 merge). Parity passed on the
first attempt.

Output as written by the CLI. Its font path, font block placement,
two English figure captions and one term are repaired in the next
commit.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Hand repairs to the seed in the previous commit:

- The engine writes FONTPATH as _fonts/...; this edition keeps the font
  in lectures/fonts/ (110 of the other 111 lectures), so the build
  would fail with FileNotFoundError. Path corrected, and the i18n block
  moved from the first plotting cell into the imports cell, where the
  rest of the edition keeps it.
- Both figure captions (cell metadata) came through in English, the
  QuantEcon/action-translation#255 class: localised to
  "运动规律与托宾 q" and "不变分布以及投资与 q 的关系".
- "law of motion" was rendered 运动法则 (axis title and one sentence);
  the edition uses 运动规律 throughout (107 occurrences), so aligned.

Verified against the English source: identical directive sequence (43),
anchors, the 51 cross-references and citations, heading levels, and
code cells (ASTs with string literals masked); every display-math block
identical except \text{with probability one} -> \text{以概率1成立},
the edition's practice. All 13 code cells execute from lectures/ with
numerical output identical to the English, and both figures render in
Source Han Serif SC with no missing-glyph warnings.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This sync wrote the source _toc.yml whole, which turned all 19 part
captions back to English (the QuantEcon/action-translation#254 class,
fixed in the engine on 2026-10-09, after this PR was opened). Rebuilt
from main's _toc.yml plus only this PR's three lectures, at their
source positions: lucas_prescott_investment and
optimal_growth_uncertainty after rational_expectations, and
lq_mean_field_games after two_computation. Every entry resolves to a
file on this branch.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
lucas_prescott_investment (5) and lq_mean_field_games (4) arrived with
their mystnb figure captions in English, the
QuantEcon/action-translation#255 class. Each caption now uses the term
its lecture's own text uses (需求序列独立 for IID demand, 遍历集,
过渡路径, 总量状态, 商店). Plot labels in both lectures are English and
need no font block; that is the edition-wide
QuantEcon/action-translation#178 class and is left as is.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

@github-actions
github-actions Bot temporarily deployed to pull request October 21, 2026 23:05 Inactive
@mmcky

mmcky commented Oct 21, 2026

Copy link
Copy Markdown
Contributor Author

Repaired on the branch (2026-10-22); the PR now delivers all of QuantEcon/lecture-python.myst#1070 and builds. Part of #298.

Commit What
cffec3b Seeds optimal_growth_uncertainty, which this sync dropped on a parity refusal (QuantEcon/lecture-python.myst#1072): translate init -f at v0.29.6 (@v0), output as written
55e77a2 Repairs to that seed: FONTPATH _fonts/ → fonts/ with the block moved to the imports cell, two English figure captions localised, 运动法则 → 运动规律 (the edition's term)
f978725 _toc.yml rebuilt from main plus this PR's three entries: the whole-file copy had turned all 19 part captions back to English (the QuantEcon/action-translation#254 class)
6c3f689 The nine English figure captions in lucas_prescott_investment and lq_mean_field_games localised (QuantEcon/action-translation#255 class)

Checks. All four lectures match their English source structurally (directive sequence, anchors, cross-references and citations, headings, code cells compared with string literals masked). Executed locally from lectures/: 75 code cells in all, numerical output identical to the English, 13 figures rendered with no missing-glyph warnings. The preview log has no execution failures and one unrelated warning; every ToC entry resolves; the pages and Chinese captions are live on the preview.

For the reviewer: "Tobin's q" appears as both 托宾 q and 托宾的 $q$ in the new lectures, as it already does across the edition.

Merge order: this PR first, then #294, then #296. Their fixes are staged and go up after this merges, since every later merge moves main under them.

@mmcky
mmcky merged commit ec71c89 into main Oct 21, 2026
7 checks passed
@mmcky
mmcky deleted the translation-sync-2026-09-27T06-05-07-pr-1070 branch October 21, 2026 23:46
mmcky added a commit that referenced this pull request Oct 22, 2026
QuantEcon/lecture-python.myst#1087 added gallant_tauchen; its sync PR,
#294, could not build until #286 landed. When #286 merged, the rebase
automation re-translated the lecture at @v0 (v0.29.6) and force-pushed
the branch, and GitHub shut that PR in the same second (the
QuantEcon/action-translation#280 race). The lecture and its state file
are taken unchanged from that branch (5d35ce7).

Checked against the English source: identical directive sequence (43),
math blocks, anchors, the 54 cross-references and citations, headings
and code cells; all 23 code cells execute with numerical output
identical to the English.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
mmcky added a commit that referenced this pull request Oct 22, 2026
…closed #294 and #296) (#300)

* Add gallant_tauchen, as the sync's rebase delivered it at v0.29.6

QuantEcon/lecture-python.myst#1087 added gallant_tauchen; its sync PR,
#294, could not build until #286 landed. When #286 merged, the rebase
automation re-translated the lecture at @v0 (v0.29.6) and force-pushed
the branch, and GitHub shut that PR in the same second (the
QuantEcon/action-translation#280 race). The lecture and its state file
are taken unchanged from that branch (5d35ce7).

Checked against the English source: identical directive sequence (43),
math blocks, anchors, the 54 cross-references and citations, headings
and code cells; all 23 code cells execute with numerical output
identical to the English.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* gallant_tauchen: localise the two English figure captions

Both mystnb figure captions arrived in English, the
QuantEcon/action-translation#255 class. Each uses the lecture's own
terms: 公共随机数 and 重新抽取扰动项 (the two curves' descriptions in
the text above the figure), 准则函数, 随机波动率 and 收益率.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Seed social_security_depletion, the lecture its sync could not deliver

QuantEcon/lecture-python.myst#1091 added social_security_depletion, but
its sync failed the structural parity check (the model dropped the
leading {raw} header block), filed as
QuantEcon/lecture-python.myst#1092, so its sync PR (#296) opened with a
_toc.yml change and no lecture.

translate init -f social_security_depletion.md at engine v0.29.6 (@v0),
claude-sonnet-5, from lecture-python.myst main (9ad04de; the file's
last change is 97c5894). The first attempt failed parity the same way
and wrote nothing; the second passed.

Output as written by the CLI. Its font path is repaired in the next
commit.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* social_security_depletion: font path

The engine writes FONTPATH as _fonts/...; this edition keeps the font in
lectures/fonts/, so the build would fail with FileNotFoundError. The
block is already in the imports cell, and nothing after it resets
font.family.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* bib: add the 21 entries the two lectures cite

gallant_tauchen cites 17 keys and social_security_depletion 4 that
this edition's bibliography lacks. Each is copied verbatim from the
source bib and placed after the nearest preceding entry the two files
share, keeping the source's order. Additions only; the same 21 keys the
sync's rebase added on the two closed PRs' branches.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* _toc.yml: add gallant_tauchen and social_security_depletion

At their source positions: gallant_tauchen after market_diffusion, and
social_security_depletion after two_computation, before
lq_mean_field_games. Built on main's _toc.yml, so the Chinese part
captions are untouched.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* gallant_tauchen state: record the file's last source commit

The sync recorded source-sha as f8d7e33, the merge commit of
QuantEcon/lecture-python.myst#1087, which was a true merge rather than
a squash. translate status compares source-sha with the file's last
commit, 648d138 (the PR's head), so it reported this lecture OUTDATED
although the source blob is identical at both. Recorded as 648d138, the
convention translate init and the other 138 state files in this edition
follow; nothing else in the file changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

This branch was previously deployed

1 inactive deployment
pull request — 6c3f689a Deployed Oct 21, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action-translation PRs created by QuantEcon/action-translation automated Automated sync PR opened by action-translation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants