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.