Skip to content

build: consume zh_CN catalogs from the guidebook submodule (single home)#11

Draft
sanchuanhehe wants to merge 1 commit into
mainfrom
chore/locales-to-editorial-repo
Draft

build: consume zh_CN catalogs from the guidebook submodule (single home)#11
sanchuanhehe wants to merge 1 commit into
mainfrom
chore/locales-to-editorial-repo

Conversation

@sanchuanhehe

Copy link
Copy Markdown
Member

🔗 Depends on theopensourceway/guidebook#265 — do not merge until that lands. The submodule pointer here references the guidebook branch commit; I'll re-point it to #265's merge commit and take this out of draft once it merges (CI will go green then — until then the submodule commit isn't reachable from theopensourceway/guidebook).

Why

Translation catalogs are editorial content and should live in the editorial repo next to the source they translate. Today they were duplicated: the canonical, maintained set here in production/locales, and an older copy in guidebook (from guidebook#261) that had drifted and was unused. CONTRIBUTING.md / README.md already document guidebook/locales/ as the home — this fixes the earlier oversight where the implementation didn't match.

What

  • conf.py: locale_dirsguidebook/locales (the submodule)
  • remove the duplicate locales/ copy from this repo
  • docs.yml: catalog-freshness check + status report now run against guidebook/locales (git -C guidebook diff --exit-code -- locales)
  • tools/i18n: default --locale-dirguidebook/locales

Verification (local)

  • ✅ English HTML: 0 warnings
  • ✅ zh_CN HTML: 0 warnings, renders Chinese
  • ✅ catalog-freshness idempotent against guidebook/locales (git -C guidebook diff --exit-code clean)

Part of the i18n infrastructure direction in discussion #260.

Translation catalogs are editorial content, so they should live in the
editorial repo next to the source they translate. This fixes an earlier
oversight where the canonical catalogs were kept here in production while
CONTRIBUTING.md/README.md already documented guidebook/locales/ as their home.

- conf.py: point locale_dirs at the guidebook submodule's locales/
- remove the duplicate locales/ copy from this repo
- docs.yml: run the catalog-freshness check and status report against
  guidebook/locales (git -C guidebook diff --exit-code)
- tools/i18n: default --locale-dir to guidebook/locales

Depends on theopensourceway/guidebook#265 (which updates the catalogs in the
editorial repo). The submodule pointer here will be moved to that PR's merge
commit before this is merged.
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