Skip to content

Restore Chinese part captions — the published ToC has been English for 17 days - #245

Merged
mmcky merged 1 commit into
mainfrom
fix/restore-chinese-toc-captions
Aug 10, 2026
Merged

Restore Chinese part captions — the published ToC has been English for 17 days#245
mmcky merged 1 commit into
mainfrom
fix/restore-chinese-toc-captions

Conversation

@mmcky

@mmcky mmcky commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

The published Chinese site has been serving 19 English section captions and zero Chinese ones since #202 merged on 2026-07-24 — seventeen days live on the flagship Chinese edition. This restores them.

What happened

#202 (84fbaca) regenerated lectures/_toc.yml as a full mirror of the English source, which carried the English captions over the 14 hand-set Chinese ones. The reviewer scored that PR PASS, 9/9/9/9, all four diff-checks true, with recommendationReasons: [] — a prose-quality reviewer does not see a structural de-localisation, which is why nothing flagged it.

This is not a revert

Upstream restructured the parts in the same change, so the caption set went from 14 to 19. The old 消费、储蓄与资本 part held 16 lectures and was dissolved four ways:

Old member Now under
cass_koopmans_1/2, cass_fiscal, cass_fiscal_2 Optimal Growth
the six os_* Introduction to Optimal Savings
the five ifp_* Household Problems
ak2 Multiple Agent Models (existing part)

Three lectures also moved out of Search into a new Reinforcement Learning part. So 13 captions are restored verbatim from f8bf219 (#202's parent) and 6 are new. The retired 消费、储蓄与资本 is not recycled — no successor part carries its scope, so reusing it would mislabel a section. 14 − 1 + 6 = 19, matching the English caption count exactly.

The six new captions are attested, not coined

Each is a phrase this edition already uses for the same English string:

Caption Attestation
强化学习 inventory_q.md:514, prospects_bounded_rationality.md:539
最优储蓄导论 os.md:11 and :28 — the part's own lead-lecture title
家庭问题 ifp_discrete.md:34 ("这个储蓄问题通常被称为收入波动问题家庭问题"), plus heading-map pairs at cass_koopmans_2.md:21 and ak_aiyagari.md:28; 29 occurrences across 11 files
宏观经济学中的有限理性 prospects_bounded_rationality.md:55, rendering Sargent (1993) — whose title is the English caption
菲利普斯曲线权衡 phillips_lost_conquest.md:53, which already names this very suite
最优增长 cass_koopmans_1.md:44, describing the part's own subject

X导论 for "Introduction to X" follows this repo's own lost caption 动态系统导论"Introduction to Dynamics". 其他 is kept at position 19 — this repo's form; lecture-intro.zh-cn uses 其它 and the two were deliberately not harmonised here.

🟡 One call for @HumphreyYang

Household Problems → 家庭问题, or 收入波动问题? This was the one genuinely contested choice.

家庭问题 translates the English caption and is what the part's own lead lecture calls its subject. But all five member lectures are titled 收入波动问题 I–V, so under 家庭问题 the caption shares no character with any page title beneath it, and bare 家庭问题 has an everyday reading ("family troubles") that prose disambiguates but a navigation label does not.

Both are defensible — ifp_discrete.md:34 explicitly equates the two names. This is a traceability-versus-clarity judgement rather than a correctness question, so it should be yours. Happy to swap it at position 10 if you prefer the series name.

Also worth a second opinion, though not contested: Optimal Growth → 最优增长 versus 最优增长模型. The bare form was chosen because the English caption is bare and the part also covers competitive equilibrium and fiscal policy, but 多主体模型 shows 模型 does appear in this repo's captions.

Scope and durability

The diff is 19 caption lines and nothing else — 19 insertions, 19 deletions, zero non-caption changed lines. No YAML quoting is needed (no ASCII colons). The trailing space on the old "Statistics and Information " is not carried over.

This is a bridge repair, not a durable fix. _toc.yml is regenerated as a full source mirror by lecture-adding syncs, so the next one reverts it — the same mechanism that caused this. Nothing enforces caption language today: the engine reads _toc.yml only for lecture discovery and no mode emits a translated caption, so review mode's gating terminology category never sees a caption regression. Filed for the durable fix. No open sync PR touches _toc.yml right now, so the window is clear.

Once merged this needs a publish tag to reach readers; verify after the ~10-minute Pages CDN window.

🤖 Generated with Claude Code

The published Chinese site has been serving 19 English section captions
and zero Chinese ones since 84fbaca (#202, 2026-07-24), which replaced
the edition's 14 hand-set Chinese captions with the English source's as
part of a full-ToC mirror regeneration. Seventeen days live.

This is not a revert of 84fbaca. Upstream restructured the parts in the
same change, so the caption set went 14 -> 19: it dissolved the old
消费、储蓄与资本 part four ways (cass_* -> Optimal Growth, os_* ->
Introduction to Optimal Savings, ifp_* -> Household Problems, and ak2
moved out to Multiple Agent Models), and split three lectures out of
Search into a new Reinforcement Learning part. So 13 captions are
restored verbatim from f8bf219 and 6 are new; the retired caption is not
recycled, because no successor part carries its scope.

Every new caption is a phrase this edition already uses for the same
English string, not a fresh coinage:

- 强化学习        inventory_q.md:514, prospects_bounded_rationality.md:539
- 最优储蓄导论     os.md:11/:28 -- the part's own lead-lecture title
- 家庭问题        ifp_discrete.md:34, and the heading-map pairs in
                 cass_koopmans_2.md:21 and ak_aiyagari.md:28
- 宏观经济学中的有限理性  prospects_bounded_rationality.md:55, rendering
                 Sargent (1993), whose title is the English caption
- 菲利普斯曲线权衡   phillips_lost_conquest.md:53, which already names this
                 very suite
- 最优增长        cass_koopmans_1.md:44, describing the part's subject

Bridge repair, not a durable fix: _toc.yml is regenerated as a full
source mirror by lecture-adding syncs, so the next one reverts this. No
open sync PR touches _toc.yml today, so the window is clear.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@mmcky

mmcky commented Aug 10, 2026

Copy link
Copy Markdown
Contributor Author

Durable fix filed as QuantEcon/action-translation#254 — sync overwrites localised _toc.yml captions and neither review mode nor the strict build can detect it. This PR remains a bridge repair until that lands.

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.

Pull request overview

Restores Chinese part captions in lectures/_toc.yml so the published zh-cn site navigation shows localized section titles instead of the English originals.

Changes:

  • Replaces 19 English parts[].caption values in lectures/_toc.yml with Chinese captions to match the zh-cn edition.

💡 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
- file: os_egm
- file: os_egm_jax
- caption: Household Problems
- caption: 家庭问题
@netlify

netlify Bot commented Aug 10, 2026

Copy link
Copy Markdown

Deploy Preview for astonishing-narwhal-a8fc64 ready!

Name Link
🔨 Latest commit a47d285
🔍 Latest deploy log https://app.netlify.com/projects/astonishing-narwhal-a8fc64/deploys/6a793c8b4bfeae0008003099
😎 Deploy Preview https://deploy-preview-245--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

Copy link
Copy Markdown

@mmcky

mmcky commented Aug 10, 2026

Copy link
Copy Markdown
Contributor Author

@HumphreyYang I am going to merge this as is. But let me know what you think re: contested translations. Then if we need to update the glossary we can do so on action-translation.

@mmcky
mmcky merged commit b16d62e into main Aug 10, 2026
8 checks passed
@mmcky
mmcky deleted the fix/restore-chinese-toc-captions branch August 10, 2026 03:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants