# API Documentation Translation: What to Skip | Vitra.ai > Most API reference should stay in English. What genuinely helps a developer in another language, and what breaks when documentation is translated wholesale. **Canonical URL**: https://www.vitra.ai/saas/api-documentation-translation **Source**: This is the Markdown rendering of https://www.vitra.ai/saas/api-documentation-translation, generated at build time from that page. --- 3 min read # API Documentation Translation: What to Skip Most API reference should stay in English. What genuinely helps a developer in another language, and what breaks when documentation is translated wholesale. [Samhitha J Bhatt](https://www.vitra.ai/author/samhitha) Senior Product Manager , Vitra.ai Updated Aug 17, 2026 ![API Documentation Translation: What to Skip](https://www.vitra.ai/static/images/blog/api-documentation-translation.jpg) Table of contents [Developers read documentation differently](#developers-read-documentation-differently) [What to translate and what to leave](#what-to-translate-and-what-to-leave) [Error messages are the exception worth funding](#error-messages-are-the-exception-worth-funding) [Do not translate what you cannot maintain](#do-not-translate-what-you-cannot-maintain) [FAQ](#faq) Contributors [Samhitha J Bhatt](https://www.vitra.ai/author/samhitha) Senior Product Manager Subscribe to our newsletter Subscribe > **Quick answer —** Translate the guides, concepts and error explanations. Leave endpoint names, parameters, code samples and the reference tables in English, because developers search and copy those in the original.[Vitra.ai Universe](https://www.vitra.ai/platform) ships product and customer content in every language. ## Developers read documentation differently A developer looking for an endpoint is not reading. They are scanning for a symbol they already half-know, then copying a code block. Translating the symbol breaks that. Translating the prose around it helps. That split is the whole decision, and getting it wrong in either direction wastes money — translating everything produces documentation nobody trusts, translating nothing leaves concepts unexplained for the majority of the world's developers who do not read English comfortably. ## What to translate and what to leave Element Translate Getting started and guides Yes Concept and architecture pages Yes Error explanations and troubleshooting Yes Endpoint names and paths No Parameter and field names No Code samples No — comments only Enum values and status codes No Reference tables Headings only Code comments are the useful middle. Translating the comment inside a sample while leaving the code untouched gives a reader the explanation without breaking copy-paste, and it is the single highest-value thing in this list. ## Error messages are the exception worth funding A developer hitting an unfamiliar error searches the exact string, so the string itself should stay in English and be searchable. The explanation next to it should not. That is where a reader in another language actually loses time, and it is covered further in [error message translation](https://www.vitra.ai/saas/error-message-translation). ## Do not translate what you cannot maintain API documentation changes with every version, and stale translated docs are worse than none — a developer following an outdated Japanese guide files a bug against behaviour that changed two releases ago. So either wire it to the release the way [release notes](https://www.vitra.ai/saas/release-note-translation) are wired, with segment [memory](https://www.vitra.ai/features/translation-memory) keeping the cost proportional to the change, or translate only the stable conceptual pages that do not move. Mark the version and date on every translated page. A developer who can see the page is three versions behind can decide for themselves; one who cannot, cannot. Run [quality control](https://www.vitra.ai/features/quality-control) with a do-not-translate list covering every symbol, or the first pass will helpfully translate your parameter names. ## FAQ **Should API reference documentation be translated?** Mostly not. Endpoint names, parameters, code samples, enum values and status codes stay in English because developers search and copy them. Guides, concepts and error explanations are worth translating. **What about code samples?** Leave the code and translate the comments inside it. That gives a reader the explanation without breaking copy-paste, and it is the highest-value change in most API documentation. **Should error strings be translated?** The string itself should stay in English so it remains searchable. The explanation beside it should be translated, because that is where a non-English reader actually loses time. **What is the risk of translating API docs?** Going stale. Documentation changes every version, and an outdated translated guide leads developers to file bugs against behaviour that already changed. Mark version and date on every translated page. Our blog ## Lastest blog posts Tool and strategies modern teams need to help their companies grow. Automotive [Automotive Brochure Localization by Market](https://www.vitra.ai/automotive/automotive-brochure-localization) A car brochure is a spec grid, a legal footer and a photo library, all market-specific. What actually has to change, and why the layout decides the schedule. [Samhitha J Bhatt](https://www.vitra.ai/author/samhitha) Aug 18, 2026 Automotive [Automotive Campaign Localization Across Markets](https://www.vitra.ai/automotive/automotive-campaign-localization) Campaigns run through national companies and dealer networks, so one master becomes hundreds of files. Where the offer text and the disclaimers actually break. [Samhitha J Bhatt](https://www.vitra.ai/author/samhitha) Aug 18, 2026 Automotive [Car Service Manual Translation for Technicians](https://www.vitra.ai/automotive/automotive-service-manual-translation) A workshop manual is read mid-repair by someone with the car on a lift. What that demands of procedures, torque figures and fault codes, in every language. [Samhitha J Bhatt](https://www.vitra.ai/author/samhitha) Aug 18, 2026 [View all posts](https://www.vitra.ai/blog/page/1) --- ## Structured data ```json { "@context": "https://schema.org", "@type": "Article", "mainEntityOfPage": { "@type": "WebPage", "@id": "https://www.vitra.ai/saas/api-documentation-translation" }, "headline": "API Documentation Translation: What to Skip", "image": [ { "@type": "ImageObject", "url": "https://www.vitra.ai/static/images/blog/api-documentation-translation.jpg" } ], "datePublished": "2026-08-17T00:00:00.000Z", "dateModified": "2026-08-17T00:00:00.000Z", "author": [ { "@type": "Person", "name": "Samhitha J Bhatt" } ], "publisher": { "@type": "Organization", "name": "Vitra.ai", "logo": { "@type": "ImageObject", "url": "https://www.vitra.ai/static/images/vitra-v-logo.png" } }, "description": "Most API reference should stay in English. What genuinely helps a developer in another language, and what breaks when documentation is translated wholesale." } ``` ```json { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.vitra.ai" }, { "@type": "ListItem", "position": 2, "name": "Saas", "item": "https://www.vitra.ai/saas" }, { "@type": "ListItem", "position": 3, "name": "API Documentation Translation: What to Skip", "item": "https://www.vitra.ai/saas/api-documentation-translation" } ] } ``` ```json { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Should API reference documentation be translated?", "acceptedAnswer": { "@type": "Answer", "text": "Mostly not. Endpoint names, parameters, code samples, enum values and status codes stay in English because developers search and copy them. Guides, concepts and error explanations are worth translating." } }, { "@type": "Question", "name": "What about code samples?", "acceptedAnswer": { "@type": "Answer", "text": "Leave the code and translate the comments inside it. That gives a reader the explanation without breaking copy-paste, and it is the highest-value change in most API documentation." } }, { "@type": "Question", "name": "Should error strings be translated?", "acceptedAnswer": { "@type": "Answer", "text": "The string itself should stay in English so it remains searchable. The explanation beside it should be translated, because that is where a non-English reader actually loses time." } }, { "@type": "Question", "name": "What is the risk of translating API docs?", "acceptedAnswer": { "@type": "Answer", "text": "Going stale. Documentation changes every version, and an outdated translated guide leads developers to file bugs against behaviour that already changed. Mark version and date on every translated page." } } ] } ```