Skip to content

docs(i18n): Simplified Chinese landing page and README - #295

Merged
jeiel85 merged 1 commit into
mainfrom
claude/pr-review-d17f97
Aug 9, 2026
Merged

docs(i18n): Simplified Chinese landing page and README#295
jeiel85 merged 1 commit into
mainfrom
claude/pr-review-d17f97

Conversation

@jeiel85

@jeiel85 jeiel85 commented Aug 9, 2026

Copy link
Copy Markdown
Owner

Follows #294, which adds values-zh to the app. This does the public half: the landing page, the privacy policy and the README are what a Chinese reader meets before installing anything, and they were still English-only.

Merge after #294. The "UI in 6 languages" line becomes 7 in all seven READMEs, which is only true once the app strings land.

New

  • docs/index.zh.html, docs/privacy.zh.html, README.zh.md
  • zh wired into the language switcher, hreflang set and og:locale:alternate list of the twelve pages that already existed, plus the language line in the six existing READMEs

hreflang="zh-Hans" and <html lang="zh-Hans"> rather than plain zh, since the content is Simplified only.

Two gate changes, both because a gate caught something

.lang-switch gains flex-wrap: wrap in style.css. A seventh chip overflows all six privacy pages by 9px at 320px, and the #187 overflow gate failed on it. landing.css already wrapped — style.css was the one that did not, so the index pages were fine and the privacy pages were not.

verify-landing-versions.ps1 learns the new files, and the demo-clip check gains a Fallback field. There is no zh tablet recording yet, so both zh surfaces point at the -en clip. Dropping them from $assetPairs would have left them unchecked — which is the exact hole that check was added to close (#258) — so the borrow is declared in the data and printed in yellow instead of hidden.

THANKS.md

Gains a ## Contributed section. The existing table is about bug reports and its prose says so ("Listed by first report"); a translation is a different kind of outside work, so it gets its own row rather than being filed under "Reported".

Verified

  • scripts/verify-landing-versions.ps1 — 7 landing pages, 7 READMEs, 14 demo-clip surfaces, all pass
  • scripts/check-landing-overflow.mjs — 14 pages × 6 widths (320–1280px), no horizontal overflow
  • Rendered both new pages at 1280px and 375px; the zh hero title measures 184px/110px, identical to ko and ja

Not in this PR

  • No zh tablet demo clip (markleaf-tablet-zh.mp4 / .gif) — the other six locales have one
  • fastlane/metadata/android/ has no zh-CN listing, and the six existing full_description.txt files still say "6 languages"
  • The five other localized READMEs still link to the English landing page and privacy policy; README.zh.md links to the zh ones

🤖 Generated with Claude Code

#294 adds `values-zh` to the app. The public surfaces did not follow, and
they are the half a Chinese reader meets first — the landing page, the
privacy policy, and the README are what you see before you install
anything.

Adds index.zh.html, privacy.zh.html and README.zh.md, and wires zh into
the language switcher, hreflang set and og:locale alternates of the
twelve pages that already existed. The "UI in 6 languages" line in all
seven READMEs becomes 7, which is why this has to land after #294 and
not before.

Two gate changes, both because the gates caught something:

- `.lang-switch` in style.css gains `flex-wrap: wrap`. A seventh chip
  overflows all six privacy pages by 9px at 320px, and the #187
  overflow gate failed on it. landing.css already wrapped; style.css
  was the one that did not.
- verify-landing-versions.ps1 learns index.zh.html / README.zh.md, and
  the demo-clip check gains a `Fallback` field. There is no zh tablet
  recording yet, so both zh surfaces point at the `-en` clip. Dropping
  them from the list would have left them unchecked — exactly the hole
  that check exists to close (#258) — so the borrow is declared and
  printed in yellow instead.

THANKS.md gains a Contributed section. The existing table is about
reports and its prose says so; a translation is a different kind of
outside work and gets its own row rather than being filed under
"Reported".

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c966b0116f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/privacy.zh.html
<link rel="stylesheet" href="style.css">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@400;500;700;800&display=swap" rel="stylesheet">

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Apply the imported Simplified Chinese font

This page imports Noto Sans SC, but docs/style.css only names Noto Sans KR and Noto Sans JP before the system fallbacks, so the downloaded family is never selected. Visitors to the Chinese privacy page therefore incur a render-blocking Google Fonts stylesheet connection while still seeing their system font; add Noto Sans SC to the applicable stack or remove this unused import.

Useful? React with 👍 / 👎.

# ---- 랜딩 페이지 ----
$docsPath = Resolve-UnderRoot $DocsDir
$landingFiles = @("index.html", "index.ko.html", "index.ja.html", "index.de.html", "index.es.html", "index.fr.html")
$landingFiles = @("index.html", "index.ko.html", "index.ja.html", "index.zh.html", "index.de.html", "index.es.html", "index.fr.html")

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Update the seven-locale release contract

Adding index.zh.html here makes the verifier enforce seven landing pages, but the repository's agent instructions and docs/RELEASE.md still explicitly define the public surfaces as six locales and omit zh. Future release work is therefore given conflicting source-of-truth instructions and may update only six surfaces before this script fails; update those release instructions alongside this list so the documented workflow matches the new contract.

AGENTS.md reference: AGENTS.md:L263-L263

Useful? React with 👍 / 👎.

@jeiel85
jeiel85 merged commit e9bdc8e into main Aug 9, 2026
6 checks passed
@jeiel85
jeiel85 deleted the claude/pr-review-d17f97 branch August 9, 2026 15:39
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