docs(i18n): align experiment/figure/table numbering across all 12 translations - #858
Merged
Conversation
The Chinese source had reader-visible figure numbering gaps left behind by earlier content removals, and the caption number no longer matched the filename in two chapters. - ch5: restore the 图5-4 embed dropped by d39b1d7 while its prose reference survived, closing the 5-3 -> 5-5 gap. - ch7: retire the two figures the chapter dropped to descriptive names and shift fig7-18/19/20 down so caption number == filename again. - ch10: renumber 10-3..10-13 to 10-2..10-11 across all 13 editions, closing the gaps at 10-2 and 10-10; retire the two removed figures to descriptive names. Drop the dangling "Figure 10-10" reference in the English edition. - Rebuild fig8-1 for the 11 editions still shipping the pre-04c0ed70 artwork. The Chinese source now has gapless, filename-aligned numbering in every chapter with no dangling cross-references. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Commit 04c0ed7 replaced all five Chinese chapter-8 figures when the chapter was reorganized around continual evolution. Only book-ko, added afterwards, picked them up; every other edition still shipped the pre-reorganization artwork, so the captions described the new chapter while the pictures showed the old one. In book-en, book-ar and book-zhtw fig8-3 was additionally still untranslated Simplified Chinese, and book-es/ja/tr carried a further two-figure offset whose fig8-3/fig8-4 showed chapter-4 material. Rebuilds fig8-1..fig8-5 for all 11 affected editions from the current Chinese geometry, translating text nodes only so the drawings stay identical, and drops the orphaned fig8-6/fig8-7 left in book-es, book-ja and book-tr. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Eight editions still carried chapter-3 figures from an earlier revision, two
of which showed the wrong drawing entirely:
- fig3-2 ("four memory strategies") rendered the RAG query flow, i.e. the
artwork belonging to fig3-5.
- fig3-4 ("multi-type memory architecture") rendered the HNSW index structure
from fig3-7.
- fig3-1 showed the retired RAG-fundamentals map instead of the chapter
knowledge map (fixed for book-en in #816, never carried across).
- fig3-11 showed the retired GraphRAG walkthrough built on the x86 SSE/AVX
instruction set -- a CPU diagram in a knowledge-graph section. In book-hu it
instead showed fig3-14's contextual retrieval.
- fig3-12 was an earlier revision of the agentic vs. non-agentic comparison.
All five are regenerated for ar, es, hu, id, ja, ru, ta and tr from the current
book-en geometry, translating text nodes only, so every edition now matches the
Chinese drawing exactly.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Every edition captioned fig9-7 as "9-6", duplicating the number already used by fig9-6, so all later captions ran one behind their file and the chapter ended with fig9-12 labelled 9-11. Captions are now renumbered to match their filenames, and the fig9-11/fig9-12 embeds (VLA, Sim2Real) are dropped to match the Chinese chapter, which removed them in #730. The files stay on disk; the course slides link fig9-11 directly. Also rebuilds fig4-9 from the Chinese for the six editions that shipped it untranslated or, in book-es and book-tr, showing a duplicate of fig4-8, and switches book-hu to the shared fig2-7.png attention heat map that the other twelve editions use. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Every edition captioned fig9-7 as "9-6", duplicating the number already used by fig9-6, so each later caption ran one behind its file and the chapter ended with fig9-12 labelled 9-11. Captions now match their filenames in all twelve editions; the figure set itself is unchanged, so the prose cross-references still resolve. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The chapter 10 renumber matched captions on the "Рис." prefix and missed the one caption written as "Рисунок 10-11", leaving it pointing at fig10-9. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…ering Chapter 9's numbering gaps at 9-5/9-6 were a prose problem, not a figure problem: eight editions had condensed the "cognitive timing" section into a single summary paragraph, so the fast/slow-thinking and Step-Audio R1 figures had nowhere to attach. Their SVGs were already present and correctly translated -- just never referenced. - Restore the three #### subsections the Chinese has (fast thinking answers / fast thinking interacts / end-to-end unification) in ar, es, hu, id, ru, ta, tr and vi, translated to match each edition's existing terminology, and re-attach fig9-5 and fig9-6. - Drop the fig9-11/fig9-12 embeds and their in-text references in all twelve editions: #730 deliberately removed both from the Chinese chapter, and the Chinese is authoritative. The VLA and Sim2Real prose stays. - book-hu: move the fig7-7 experiment box back ahead of the pre-training section and the fig10-9 MetaGPT section after fig10-8, matching the Chinese reading order. Chapter 9 is now exactly ten figures in all thirteen editions, and every chapter of every edition is gapless, caption-aligned and in order. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…w, ja, es, ru, tr) Commit 05ab7f3 condensed the Chinese reward-design section into four subsections; the translations still carried the superseded version, roughly ten times longer and organised differently, along with fig7-16 and fig7-17 which the Chinese no longer has. Replaces the three old reward subsections with a translation of the current Chinese four-subsection structure and adds the [^ch7-23] and [^ch7-29] footnotes, which existed only in the Chinese. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Commit 05ab7f3 condensed the Chinese reward-design section from three loosely organised subsections into four sharper ones and dropped two figures. The translations never followed, so every edition still shipped the superseded version -- roughly ten times longer than the Chinese and structured differently -- along with fig7-16 and fig7-17, which no longer exist upstream. - Replace the old reward subsections in ar, en, es, hu, id, ja, ko, ru, ta, tr, vi and zhtw with a translation of the current Chinese four-subsection structure, matching each edition's established terminology. - Add the [^ch7-23] and [^ch7-29] footnotes, previously Chinese-only. - Retire fig7-16/fig7-17 to descriptive names and shift fig7-18/19/20 down, so chapter 7 is 18 figures with caption number == filename in every edition, exactly as the Chinese source now is. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
fig4-7 and fig4-8 shipped with untranslated Chinese labels in book-en, book-ar, book-ta and book-vi; the Arabic copies were additionally part-machine-translated into garbled mixtures. Both are rebuilt from the Chinese geometry with proper translations, keeping tool identifiers and protocol role names as-is. Also translates the one English sentence left in book-ta's fig9-4. The Chinese text remaining in fig2-6 and fig10-5 is deliberate: it is the example sentence being analysed and the glossary data the figure illustrates. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…n/numbering-alignment # Conflicts: # book-ar/chapter7.ar.md # book-ar/chapter9.ar.md # book-en/chapter7.md # book-en/chapter9.md # book-es/chapter7.es.md # book-es/chapter9.es.md # book-hu/chapter10.md # book-hu/chapter7.md # book-hu/chapter9.md # book-id/chapter7.md # book-id/chapter9.md # book-ja/chapter7.ja.md # book-ja/chapter9.ja.md # book-ko/chapter7.ko.md # book-ko/chapter9.ko.md # book-ru/chapter7.md # book-ru/chapter9.md # book-ta/chapter7.ta.md # book-ta/chapter9.ta.md # book-tr/chapter7.tr.md # book-tr/chapter9.tr.md # book-vi/chapter7.vi.md # book-vi/chapter9.vi.md # book-zhtw/chapter7.zhtw.md # book-zhtw/chapter9.zhtw.md # book/chapter10.md # book/chapter7.md # book/images/fig8-17.svg # book/images/fig8-18.svg # slides/public/images/fig10-13.svg
…nslations Bring the numbering skeleton of every translated edition into line with the Chinese edition, so that later structural work can be applied mechanically. The Chinese edition is the source of truth throughout. Experiments - ch2: add the missing 实验 2-7 (writing Skill from personal samples) to all 12 editions and shift the following experiments 2-7..2-9 → 2-8..2-10; rename the accompanying footnote ch2-7 → ch2-8 to match. - ch4: add the missing multimodal-extraction experiment as 4-2 to 10 editions and shift 4-2..4-6 → 4-3..4-7. book-en had this experiment mislabelled as "Experiment 3-7" (colliding with a real 3-7 in chapter 3) and placed before 4-1; it is relabelled 4-2 and moved after the 4-1 box. Chapter summaries that enumerate the experiments are updated (six → seven, ranges corrected). - ch5: book-hu had the production-log experiment mislabelled 5-5 (duplicating the real 5-5) and was missing 5-7 entirely; the box is renumbered 5-8 and a translation of 实验 5-7 (adaptive log parser) is added. - ch7: add the missing 7-12 (V-IRL-VL) and 7-13 (SimpleVLA-RL) boxes to all 12 editions, together with the [^ch7-24] footnote they cite. Also fix the stale in-text numbers: ReTool was cited as 7-15 (it is 7-14) and RLVP as 7-14 (it is 7-16). Figures - ch9: 8 editions compressed the fast/slow-thinking section into a single paragraph and therefore lost 图9-5 and 图9-6. The three-solution block is translated in full so all editions carry the same figure inventory. Tables - ch6: remove the translation-only Pass@k/Pass^k table (no counterpart in the Chinese) and renumber 6-4..6-6 → 6-3..6-5. In book-en this table also duplicated the number of the memory-system table. - ch10: remove the translation-only shared/non-shared selection-criteria table and renumber 10-2..10-4 → 10-1..10-3. - ch9: add the 表9-1 caption to the MiniCPM-o experiment in 11 editions. - book-id ch3: translate the untranslated "Table 3-3" caption. - book-ar ch7: fix the transposed table number 1-7 → 7-1. Other consistency fixes - book-hu: 542 headings and labels across all chapters had their bold markers replaced by straight double quotes, which hid whole experiment boxes from the numbering. Restored (code blocks left untouched; the edition uses „…" for real quotations). - book-hu ch10: move the 10-4 experiment box back into the manager-pattern section so 图10-8 precedes 图10-9. - book-ar ch2: drop an Arabic-only passage (and its [^ch2-5] footnote) that has no counterpart in the Chinese. - book-ru ch2: add the missing [^lost-in-the-middle] footnote. - book-vi ch1: Thử nghiệm 1.2 → 1-2. After this change the only remaining gap is book-ar/chapter4, which is covered by the separate chapter-4 retranslation PR. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Picks up the Arabic chapter 4 retranslation (#857), which closes the one gap the numbering audit had left open. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
bojieli
added a commit
that referenced
this pull request
Aug 15, 2026
main squash-merged #858, whose content this branch already contains; the tree is kept as-is so only the Chapter 6 restructure remains as the diff. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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
1 participant
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.
Brings the numbering skeleton of every translated edition into line with the Chinese edition, so the Chapter 6 "Interaction" restructure can afterwards be applied mechanically. The Chinese edition is the source of truth throughout.
Why
An audit against the Chinese edition found that the translations were not 1:1 structural copies: experiments were missing or mislabelled, two figures had been dropped, and two tables existed only in the translations. Any renumbering script written against the Chinese inventory would therefore have renamed the wrong boxes.
What changed
Experiments
实验 2-7(creating a "de-AI-ified" writing Skill) to all 12 editions; shifted 2-7..2-9 → 2-8..2-10; renamed footnotech2-7→ch2-8to match.book-enhad it mislabelledExperiment 3-7(colliding with a real 3-7 in chapter 3) and placed before 4-1 — relabelled and moved. Summary sentences that enumerate the experiments updated (six → seven, ranges corrected).book-huhad the production-log experiment mislabelled 5-5 (duplicating the real 5-5) and was missing 5-7 entirely. Renumbered to 5-8 and added a translation of实验 5-7.[^ch7-24]footnote they cite. Fixed stale in-text numbers: ReTool was cited as 7-15 (it is 7-14), RLVP as 7-14 (it is 7-16).Figures
图9-5/图9-6. The three-solution block is translated in full so every edition carries the same figure inventory.Tables
book-enit also duplicated the memory-system table's number) and renumbered 6-4..6-6 → 6-3..6-5.表9-1caption to the MiniCPM-o experiment in 11 editions.book-idch3 — translated an untranslatedTable 3-3caption.book-arch7 — fixed a transposed1-7→7-1.Other
book-hu— 542 headings/labels across all chapters had their bold markers replaced by straight double quotes, which hid whole experiment boxes. Restored (code blocks untouched; the edition uses„…"for real quotations).book-huch10 — moved the 10-4 experiment box back into the manager-pattern section so图10-8precedes图10-9.book-arch2 — dropped an Arabic-only passage (and its[^ch2-5]footnote) with no Chinese counterpart.book-ruch2 — added the missing[^lost-in-the-middle]footnote.book-vich1 —Thử nghiệm 1.2→1-2.Verification
A script compares every edition against the pre-restructure Chinese baseline on four axes — experiment inventory, figure inventory and order, numbered-table inventory, thought-question count — plus dangling-footnote and code-fence checks. All 12 editions × 10 chapters now match, with one known exception:
book-ar/chapter4, which is covered by the separate chapter-4 retranslation PR (#857).Known divergences left for follow-up
Chapter 7 has a genuine content divergence in all 12 editions (missing
SFT 数据合成and工具调用sections, different section split for RL algorithms and distillation, 8 missing footnotes, reordered reward/tool-calling sections). That is a full-chapter re-sync and is out of scope here.🤖 Generated with Claude Code