Update 101 stale zh translations to match current EN source by github-actions[bot] · Pull Request #5515 · fern-api/docs

github-actions · 2026-05-15T10:54:49Z

Summary

Re-translates all 101 zh translation files whose English source changed since the initial translation batch (PR #5203, May 1). This fixes:

4 pages with broken image links: writer.mdx (EN switched from screenshot to video), runnable-endpoint.mdx (EN switched from screenshot to live component), welcome.mdx (EN removed Fern Definition card with SVG), 2025-10-17.mdx (EN changed runnable-endpoint image)
97 additional stale pages where EN content had been updated but zh translations were not

Translations generated via Anthropic Claude API from current EN source, preserving MDX structure, component tags, frontmatter format, and the same translation style as the original batch.

Review & Testing Checklist for Human

Spot-check 3-5 translated pages on the preview deployment to verify translation quality (prose reads naturally, no untranslated sections, no garbled component tags)
Verify the previously broken pages now render correctly:
- zh Writer page — should show video, not broken image
- zh Runnable Endpoint — should show live component, not broken image
- zh Welcome — no broken SVGs
Check that MDX component tags (<Steps>, <Tabs>, <Note>, etc.) are preserved correctly and not translated

Notes

See also PR #5522 which adds a CI workflow to automatically re-translate stale zh files when EN source changes on main, preventing this from recurring.

Link to Devin session: https://app.devin.ai/sessions/14ca348f182f4957985bb57cd50e0031

github-actions · 2026-05-15T11:03:41Z

🌿 Preview your docs: https://fern-preview-devin-fix-broken-links.docs.buildwithfern.com/learn

devin-ai-integration · 2026-05-15T11:14:23Z

Verified all 5 broken links are fixed using the preview deployment:

✅ zh Writer page — video renders at top, no broken writer-slack.png or writer-open-pr.png
✅ zh Runnable Endpoint component page — live <RunnableEndpoint> component renders instead of broken screenshot
✅ zh Welcome page — no Fern Definition card (no broken fern-definition-{dark,light}.svg)

Root cause: Fern's CAS only resolves images referenced in English source MDX. Zh translations referencing images not used in EN produced unresolved relative paths. Fix aligns zh pages with their EN counterparts.

devin-ai-integration · 2026-05-15T11:24:06Z

Updated approach based on @davidkonigsberg's feedback: instead of manually editing zh translation content, the fix now deletes the 4 stale zh MDX files so Fern's auto-translation falls back to the current EN source.

Root cause: the zh translations were created as point-in-time snapshots (PR #5203, May 1). The EN source was updated afterward (video replaced image, live component replaced screenshot, Fern Definition card archived), but the zh translations were never synced.

Preview links for verification (once preview deploys):

Note: ~100 other zh translation files are also stale (EN changed since creation). This PR only addresses the 4 causing broken image links.

Re-translates all zh MDX files whose English source changed since the initial translation batch (PR #5203, May 1). This fixes: - Broken image links (writer.mdx, runnable-endpoint.mdx, welcome.mdx, 2025-10-17.mdx) where EN switched from images to video/live components - 97 additional pages that had drifted from EN content Translations generated via Anthropic Claude API from current EN source, preserving MDX structure, component tags, and frontmatter format.

github-actions

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

vale

github-actions · 2026-05-15T12:28:39Z

+您可以指定部署服务器的环境。

-## 单 URL 环境
+## 单URL环境


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] '单URL环境' should use sentence-style capitalization.

github-actions · 2026-05-15T12:28:39Z

 ```

-## 每个环境多个 URL
+## 每个环境多个URL


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] '每个环境多个URL' should use sentence-style capitalization.

github-actions · 2026-05-15T12:28:39Z

+<Note>通过提供默认环境，生成的SDK将设置为开箱即用地访问该URL。</Note>

-## URL 模板
+## URL模板


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'URL模板' should use sentence-style capitalization.

github-actions · 2026-05-15T12:28:39Z

 | `boolean` | 布尔值 true/false |
-| `datetime` | [RFC 3339, section 5.6 datetime](https://ijmacd.github.io/rfc3339-iso8601/)。例如，`2017-07-21T17:32:28Z` |
-| `date` | RFC 3339, section 5.6 日期 (YYYY-MM-DD)。例如，`2017-07-21` |
+| `datetime` | [RFC 3339, section 5.6 datetime](https://ijmacd.github.io/rfc3339-iso8601/) 格式。例如：`2017-07-21T17:32:28Z` |


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'RFC' has no definition.

github-actions · 2026-05-15T12:28:39Z

-| `datetime` | [RFC 3339, section 5.6 datetime](https://ijmacd.github.io/rfc3339-iso8601/)。例如，`2017-07-21T17:32:28Z` |
-| `date` | RFC 3339, section 5.6 日期 (YYYY-MM-DD)。例如，`2017-07-21` |
+| `datetime` | [RFC 3339, section 5.6 datetime](https://ijmacd.github.io/rfc3339-iso8601/) 格式。例如：`2017-07-21T17:32:28Z` |
+| `date` | RFC 3339, section 5.6 日期格式 (YYYY-MM-DD)。例如：`2017-07-21` |


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'RFC' has no definition.

github-actions · 2026-05-15T12:28:40Z

 ```

-### Page "X" was removed. The previously published URL "/old" will return 404 without a redirect.
+### Page "X" was removed. The previously published URL "/old" will return 404 without a redirect. Consider adding a redirect in docs.yml to preserve existing links.


⚠️ [vale] _{reported by reviewdog 🐶}
[FernStyles.Current] Avoid time-relative terms like 'old' that become outdated

github-actions · 2026-05-15T12:28:40Z

 ```

-### Page "X" was removed. The previously published URL "/old" will return 404 without a redirect.
+### Page "X" was removed. The previously published URL "/old" will return 404 without a redirect. Consider adding a redirect in docs.yml to preserve existing links.


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.HeadingPunctuation] Don't use end punctuation in headings.

github-actions · 2026-05-15T12:28:40Z

 title: Webhook 签名验证
-description: 在您的 Fern 生成的 SDK 中配置 webhook 签名验证，以验证 HMAC 或非对称签名、防范重放攻击并确保 webhook 真实性。
-sidebar-title: Webhook 签名验证
+description: 在你的 Fern 生成的 SDK 中配置 webhook 签名验证，验证 HMAC 或非对称签名，防止重放攻击，并确保 webhook 的真实性。


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'HMAC' has no definition.

github-actions · 2026-05-15T12:28:40Z

 Fern 支持两种签名验证方法：
- **基于哈希的消息认证码（HMAC）** — 使用共享密钥的对称密钥验证
- **非对称** — 使用 RSA、椭圆曲线数字签名算法（ECDSA）或 Ed25519 密钥的公钥验证
+- **基于哈希的消息认证码 (HMAC)** — 使用共享密钥的对称密钥验证


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'HMAC' has no definition.

github-actions · 2026-05-15T12:28:40Z

- **基于哈希的消息认证码（HMAC）** — 使用共享密钥的对称密钥验证
- **非对称** — 使用 RSA、椭圆曲线数字签名算法（ECDSA）或 Ed25519 密钥的公钥验证
+- **基于哈希的消息认证码 (HMAC)** — 使用共享密钥的对称密钥验证
+- **非对称** — 使用 RSA、椭圆曲线数字签名算法 (ECDSA) 或 Ed25519 密钥的公钥验证


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Acronyms] 'ECDSA' has no definition.

devin-ai-integration Bot changed the title ~~Fix broken links (Devin)~~ Fix broken links in zh translations May 15, 2026

devin-ai-integration Bot marked this pull request as ready for review May 15, 2026 11:14

devin-ai-integration Bot requested a review from devalog as a code owner May 15, 2026 11:14

devin-ai-integration Bot requested a review from davidkonigsberg May 15, 2026 11:14

devin-ai-integration Bot changed the title ~~Fix broken links in zh translations~~ Fix broken links in zh translations by removing stale translation files May 15, 2026

devin-ai-integration Bot mentioned this pull request May 15, 2026

Add nightly workflow to auto-translate stale zh files #5522

Merged

3 tasks

devin-ai-integration Bot force-pushed the devin/fix-broken-links branch from 80c9bb3 to d7969ee Compare May 15, 2026 12:27

devin-ai-integration Bot changed the title ~~Fix broken links in zh translations by removing stale translation files~~ Update 101 stale zh translations to match current EN source May 15, 2026

github-actions Bot commented May 15, 2026

View reviewed changes

devalog approved these changes May 15, 2026

View reviewed changes

devalog merged commit ebc6639 into main May 15, 2026
4 checks passed

devalog deleted the devin/fix-broken-links branch May 15, 2026 22:40

Uh oh!

Conversation

github-actions Bot commented May 15, 2026 • edited by devin-ai-integration Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Review & Testing Checklist for Human

Notes

Uh oh!

github-actions Bot commented May 15, 2026

Uh oh!

devin-ai-integration Bot commented May 15, 2026

Uh oh!

devin-ai-integration Bot commented May 15, 2026

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions Bot May 15, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot May 15, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot May 15, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot May 15, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot May 15, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot May 15, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot May 15, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot May 15, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot May 15, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot May 15, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

github-actions Bot commented May 15, 2026 •

edited by devin-ai-integration Bot

Loading