Inicie documentos de interfaz en varios idiomas con definiciones de campos: nombres, tipos, unidades, rangos y significados de valores nulos y faltantes. Distinga los identificadores de protocolo de las explicaciones del lector. A menos que la definición de la interfaz lo permita, no cambie los identificadores de campo, los valores de enumeración o los códigos de error al traducir el lenguaje natural.

Mantener versiones y asignaciones para cambios

Cuando cambie el significado de los parámetros, los valores predeterminados, el manejo de errores o la estructura, registre la versión de la interfaz y las reglas de migración. Vincule documentos localizados a la misma versión y marque las secciones que aún no están actualizadas. Guarde definiciones, revisiones y ejemplos anteriores para evitar mezclar instrucciones antiguas y nuevas.

Verifique los ejemplos con la interfaz real

Analice solicitudes y respuestas en el entorno acordado. Verifique campos, valores y ramas de error. Utilice identificadores estables para vincular explicaciones de errores localizados. Verifique los parámetros faltantes, los valores no válidos y las versiones no compatibles. Informar los ejemplos traducidos como verificados solo después de realizar las comprobaciones correspondientes.

Verifique el idioma y la dirección del texto juntos

La guía de internacionalización del W3C analiza la información sobre el idioma y la dirección del texto para mensajes en lenguaje natural. Distinguir explicaciones legibles de identificadores de programas. Consulte texto bidireccional, fragmentos de código y presentación de números. Conservar los resultados de renderizado y análisis. El diseño legible no reemplaza la verificación de la función del protocolo.

Ver Guía de internacionalización del W3C.