Inicie documentos de interface entre idiomas com definições de campo: nomes, tipos, unidades, intervalos e significados de valores nulos e ausentes. Distinguir identificadores de protocolo das explicações do leitor. A menos que a definição da interface permita, não altere identificadores de campo, valores de enumeração ou códigos de erro ao traduzir a linguagem natural.

Mantenha versões e mapeamentos para alterações

Quando o significado dos parâmetros, padrões, tratamento de erros ou alterações na estrutura, registre a versão da interface e as regras de migração. Vincule documentos localizados à mesma versão e marque as seções ainda não atualizadas. Salve definições, revisões e exemplos anteriores para evitar misturar instruções novas e antigas.

Verifique os exemplos em relação à interface real

Analise solicitações e respostas no ambiente acordado. Verifique campos, valores e ramificações de erro. Use identificadores estáveis ​​para vincular explicações de erros localizadas. Verifique parâmetros ausentes, valores inválidos e versões não suportadas. Relate exemplos traduzidos como verificados somente após realizar as verificações correspondentes.

Verifique o idioma e a direção do texto juntos

As orientações de internacionalização do W3C discutem informações sobre idioma e direção de texto para mensagens em linguagem natural. Distinguir explicações legíveis de identificadores de programas. Verifique texto bidirecional, trechos de código e apresentação de números. Retenha os resultados de renderização e análise. O layout legível não substitui a verificação da função do protocolo.

Ver Orientação de internacionalização do W3C.