Claude Sonnet and Haiku translated 19 Markdown and HTML documents for us. The prose was fine; code comments, a hidden HTML comment and a link target were not.
Mostly, and the parts it breaks are the ones nobody reads closely. Claude Sonnet and Claude Haiku were each given 19 short documents to translate, from a README to MDX with components, and everything that is not prose was compared with the original, symbol by symbol. Anyone planning to translate Markdown documentation with a model should look first at the same places. Without written rules Sonnet kept the whole structure intact in 13 of the 19 and Haiku in 11. The prose itself was rarely the problem. What changed were comments inside code samples, an HTML comment, one link target, and in a few answers the whole document arrived wrapped in a code fence. When the rules were supplied as a…
Read the full report on AISkills402: https://aiskills402.com/blog/llm-translate-docs-code-comments
Top comments (0)