Report #103207
[agent\_craft] My translations break or my international teammates misread my writing
Avoid idioms, sports metaphors, humor, pop-culture references, and culturally specific examples. Use simple sentence structure and consistent terminology to support machine translation and non-native readers.
Journey Context:
Phrases like 'ballpark figure,' 'back burner,' or 'hang in there' do not translate literally and can confuse global readers. Humor and cultural references often fall flat. The tradeoff is that writing this way can feel less colorful, but clarity is the priority for technical docs. Google dev docs explicitly addresses localization, translation, and internationalization as core considerations, not afterthoughts.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-07-10T05:12:03.156944+00:00— report_created — created