Skip to content

Setup action-translation v0.11.0 infrastructure#67

Merged
mmcky merged 3 commits intomainfrom
setup-action-translation-v2
Mar 20, 2026
Merged

Setup action-translation v0.11.0 infrastructure#67
mmcky merged 3 commits intomainfrom
setup-action-translation-v2

Conversation

@mmcky
Copy link
Contributor

@mmcky mmcky commented Mar 20, 2026

Summary

Sets up action-translation v0.11.0 infrastructure for automated sync with the English source repo. This replaces the closed PR #66, using the new v0.11.0 safeguards to properly verify sync state before bootstrapping.

Process followed

This PR was created following the Connect an Existing Target tutorial with the new v0.11.0 safeguards:

  1. Status diagnostic — 23 aligned, 7 missing heading-maps, 2 section-less files
  2. LLM sync check (--check-sync) — verified all 25 files against source:
    • 14 I18N_ONLY (faithful translations)
    • 7 TARGET_HAS_ADDITIONS (extra explanatory content in Farsi — preserved)
    • 2 CONTENT_CHANGES (status.md missing GPU/JAX sections, python_by_example.md missing directives)
    • 1 IDENTICAL
  3. Forward resync — updated the 2 stale files to match current source
  4. Heading-maps — generated/updated all 23 files with sections (2 section-less skipped); fixed YAML quoting for colon in python_essentials.md
  5. Doctor — all 4 checks pass ✅
  6. Write state — bootstrapped .translate/ metadata (safeguard verified source dates)

Changes

Commit 1: Resync stale translations

  • status.md: added missing GPU access and JAX backend check sections
  • python_by_example.md: restored missing {index} directives and {doc} cross-references

Commit 2: Update heading-maps

  • 4 files: new heading-maps generated (about_py, functions, getting_started, python_by_example)
  • 19 files: updated from slug-based keys to full heading text with :: nesting
  • Fix YAML quoting for heading containing colon (python_essentials.md)

Commit 3: Bootstrap metadata + workflow

  • .translate/config.yml — links to source repo, target language fa, docs folder lectures
  • .translate/state/*.yml — 25 state files tracking source commit SHAs
  • .github/workflows/review-translations.yml — Claude quality review on translation PRs

Notable findings from --check-sync

  • sympy.md — target fixes a bug: factorial(n-r)factorial(n-x) (undefined variable). Consider backporting.
  • about_py.md, getting_started.md, intro.md, oop_intro.md — target has extra explanatory content added by translators. These additions are preserved.
  • getting_started.md — has some content drift (wrong conda command, outdated URLs). May want to forward-resync after merge.

Next steps

After merging this PR:

  1. Add ANTHROPIC_API_KEY secret to lecture-python-programming.fa repo settings
  2. Merge the source repo sync workflow PR ([translation] Add Farsi (fa) translation sync workflow lecture-python-programming#486)
  3. Future source PRs touching lectures/**/*.md will auto-create translation PRs here

mmcky added 3 commits March 20, 2026 16:12
- status.md: added missing GPU access and JAX backend sections
- python_by_example.md: restored missing index directives and doc links
- 4 files: new heading-maps generated (about_py, functions, getting_started, python_by_example)
- 19 files: updated from slug-based to full heading text with :: nesting
- 2 files: unchanged (intro, status — section-less)
- Fix YAML quoting for heading containing colon (python_essentials.md)
- .translate/config.yml: source=en, target=fa, docs=lectures, tool-version=0.11.0
- .translate/state/: 25 state files tracking source commit SHAs
- .github/workflows/review-translations.yml: Claude quality review on translation PRs

State verified via --check-sync before --write-state (v0.11.0 safeguard)
@netlify
Copy link

netlify bot commented Mar 20, 2026

Deploy Preview for majestic-griffin-10b166 ready!

Name Link
🔨 Latest commit 4b4fd51
🔍 Latest deploy log https://app.netlify.com/projects/majestic-griffin-10b166/deploys/69bcd8d97158dc0007ee11d3
😎 Deploy Preview https://deploy-preview-67--majestic-griffin-10b166.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

@mmcky mmcky merged commit 3f9c65e into main Mar 20, 2026
7 checks passed
@mmcky mmcky deleted the setup-action-translation-v2 branch March 20, 2026 05:43
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.

1 participant