Skip to content

Bootstrap .translate metadata for the 11 files the resync wave never touched#195

Merged
mmcky merged 1 commit into
mainfrom
translate/state-bootstrap
Jul 22, 2026
Merged

Bootstrap .translate metadata for the 11 files the resync wave never touched#195
mmcky merged 1 commit into
mainfrom
translate/state-bootstrap

Conversation

@mmcky

@mmcky mmcky commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Final piece of the QuantEcon/project-translation#14 step-1 audit: files with no .translate/state were invisible to sync discovery (the wave's known blind spot). This adds the missing metadata so discovery sees the whole corpus.

Contents (23 files):

  • 11 new .translate/state/ entriescass_fiscal_2, cass_koopmans_2, cross_product_trick, divergence_measures, hoist_failure, intro, markov_asset, perm_income, re_with_feedback, uncertainty_traps, zreferences
  • 11 heading-map injections (translate headingmap, position-based, frontmatter-only — no body changes) for the same files, which as hand-translated files never had maps; without them section-level sync cannot match sections
  • .translate/config.yml — the repo had state files but no config

Safety on the --force write: six of these files had source commits newer than their translations, so --write-state correctly refused at first. Each was triaged by translate forward before forcing: cass_fiscal_2 and intro came back IDENTICAL (the upstream changes are already reflected / netted out), and the other four I18N_ONLY (the target's deliberate CJK font-config and figsize conventions). No real drift is masked by recording current source HEAD as their baseline. The 73 existing state files are untouched.

Verification: translate status on this branch reads 84 aligned + 37 source-only, zero outdated, zero missing heading-maps — the target corpus is fully visible and verified convergent. With this merged, the only remaining #14 items are the sync automation (QuantEcon/lecture-python.myst#979 + org-secret check) and the e2e verification.

🤖 Generated with Claude Code

…touched

Closes the wave's discovery blind spot (QuantEcon/project-translation#14 step 1): files with no .translate/state were invisible to sync discovery. Adds state entries and heading maps for the 11 hand-translated files, plus the repo's missing .translate/config.yml.

Safety: the six files whose source was newer than target were first triaged by translate forward — cass_fiscal_2 and intro verdict IDENTICAL, markov_asset/perm_income/re_with_feedback/uncertainty_traps verdict I18N_ONLY (font-config and figsize conventions) — so recording current source HEAD as the baseline masks no real drift. Existing state files are untouched.

Result: translate status now reads 84 aligned + 37 source-only, with zero outdated and zero missing heading-maps.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 22, 2026 01:23
@netlify

netlify Bot commented Jul 22, 2026

Copy link
Copy Markdown

Deploy Preview for astonishing-narwhal-a8fc64 ready!

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

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

This PR completes the step-1 translation audit by making previously “invisible” hand-translated lectures discoverable to the translation/sync tooling. It does this by adding missing .translate/state baselines and injecting translation: frontmatter (including heading maps where needed) so section-level alignment can be computed across the full corpus.

Changes:

  • Add .translate/config.yml to define source/target languages and the docs folder for the translation tooling.
  • Add 11 new .translate/state/*.md.yml state files to baseline source SHAs for lectures that previously had no state.
  • Inject translation: frontmatter (title + heading maps) into 11 lecture Markdown files to enable section-level sync matching.

Reviewed changes

Copilot reviewed 23 out of 23 changed files in this pull request and generated no comments.

Show a summary per file
File Description
.translate/config.yml Adds translation tool configuration (langs + docs folder).
.translate/state/cass_fiscal_2.md.yml Adds baseline source SHA + sync metadata for discovery/resync.
.translate/state/cass_koopmans_2.md.yml Adds baseline source SHA + sync metadata for discovery/resync.
.translate/state/cross_product_trick.md.yml Adds baseline source SHA + sync metadata for discovery/resync.
.translate/state/divergence_measures.md.yml Adds baseline source SHA + sync metadata for discovery/resync.
.translate/state/hoist_failure.md.yml Adds baseline source SHA + sync metadata for discovery/resync.
.translate/state/intro.md.yml Adds baseline source SHA + sync metadata for discovery/resync.
.translate/state/markov_asset.md.yml Adds baseline source SHA + sync metadata for discovery/resync.
.translate/state/perm_income.md.yml Adds baseline source SHA + sync metadata for discovery/resync.
.translate/state/re_with_feedback.md.yml Adds baseline source SHA + sync metadata for discovery/resync.
.translate/state/uncertainty_traps.md.yml Adds baseline source SHA + sync metadata for discovery/resync.
.translate/state/zreferences.md.yml Adds baseline source SHA + sync metadata for discovery/resync.
lectures/cass_fiscal_2.md Injects translation: frontmatter with title + heading map for section alignment.
lectures/cass_koopmans_2.md Injects translation: frontmatter with title + heading map for section alignment.
lectures/cross_product_trick.md Injects translation: frontmatter with title + heading map for section alignment.
lectures/divergence_measures.md Injects translation: frontmatter with title + heading map for section alignment.
lectures/hoist_failure.md Injects translation: frontmatter with title + heading map for section alignment.
lectures/intro.md Injects translation: frontmatter with title for discovery.
lectures/markov_asset.md Injects translation: frontmatter with title + heading map for section alignment.
lectures/perm_income.md Injects translation: frontmatter with title + heading map for section alignment.
lectures/re_with_feedback.md Injects translation: frontmatter with title + heading map for section alignment.
lectures/uncertainty_traps.md Injects translation: frontmatter with title + heading map for section alignment.
lectures/zreferences.md Injects translation: frontmatter with title for discovery.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@github-actions

Copy link
Copy Markdown

@github-actions
github-actions Bot temporarily deployed to pull request July 22, 2026 01:31 Inactive
@mmcky
mmcky merged commit 0344c82 into main Jul 22, 2026
8 checks passed
@mmcky
mmcky deleted the translate/state-bootstrap branch July 22, 2026 01:38
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