{"id":36,"type":"blog","title":"From Thai Draft to English Technical Documentation","slug":"thai-draft-to-english-technical-documentation","canonicalUrl":"https://docs.phatysd.me/content/thai-draft-to-english-technical-documentation","status":"published","revision":2,"publishedAt":"2026-09-19T16:34:11.292Z","updatedAt":"2026-09-19T16:34:11.292Z","hierarchyPath":"Web Blog > Engineering Journal > Documentation","topics":["Technical writing","Localization","AI agents","Documentation quality"],"tags":["writing","localization","agents","english","documentation"],"related":[{"slug":"what-i-learned-writing-nextjs-guide-agents","title":"What I Learned from Writing a Next.js Guide for Agents","type":"blog","canonicalUrl":"https://docs.phatysd.me/content/what-i-learned-writing-nextjs-guide-agents"},{"slug":"building-agent-readable-knowledge-site","title":"Building an Agent-Readable Knowledge Site","type":"blog","canonicalUrl":"https://docs.phatysd.me/content/building-agent-readable-knowledge-site"}],"body":"# From Thai Draft to English Technical Documentation\n\nThe first version of the documentation was written in Thai because that was the fastest way to capture the operational context. The published audience, however, includes coding agents and developers who expect English technical vocabulary, predictable headings, and searchable source references. Translation was therefore an information-architecture task, not a word-for-word replacement.\n\n## Preserve meaning before style\n\nThe first pass kept the technical nouns stable: Server Component, Client Component, Server Action, Route Handler, `proxy.ts`, `DATABASE_URL`, `AUTH_URL`, revision, canonical URL, and cache tag. Translating or paraphrasing these identifiers would make code search and troubleshooting worse.\n\nThe prose around them became English, while code, commands, environment names, and URL paths remained exact.\n\n## Make headings searchable\n\nHeadings were rewritten as direct English concepts:\n\n- “Agent summary” instead of a general introduction.\n- “Public content contract” instead of a broad explanation of the site.\n- “Debugging a localhost redirect” instead of a narrative-only bug title.\n- “Verification checklist” instead of an implied conclusion.\n\nThis makes table-of-contents navigation and retrieval more useful to both people and agents.\n\n## Keep examples executable\n\nEvery code block should be valid enough to communicate the intended API. Comments should explain the boundary in English, not hide an important rule in a language the target agent may not parse consistently. Placeholder credentials remain placeholders; production secrets never belong in examples.\n\n## Use source maps, not authority by tone\n\nEnglish prose can sound authoritative even when it is only a recommendation. Each framework-sensitive section links to official Next.js, Auth.js, GitLab, Cloudflare, Heroku, or Drizzle documentation. Repository-specific behavior links back to the actual contract or source file.\n\n## Visual QA still matters\n\nText correctness does not guarantee readable rendering. Fenced code blocks need a code-specific CSS rule because an inline-code background can override the block style through selector specificity. After translating the article, the page, Markdown endpoint, JSON endpoint, and deployed CSS were checked again.\n\n## Takeaway\n\nGood technical localization preserves identifiers, improves retrieval structure, keeps examples executable, and verifies the rendered result. The output is not merely translated text; it is a more reliable interface for the next reader or agent.\n\n## References\n\n- [Next.js documentation](https://nextjs.org/docs/app)\n- [Auth.js documentation](https://authjs.dev/)\n- [GitLab OAuth documentation](https://docs.gitlab.com/integration/oauth_provider/)\n- [Cloudflare Error 525](https://developers.cloudflare.com/support/troubleshooting/http-status-codes/cloudflare-5xx-errors/error-525/)\n"}