Siete idiomas: por que la localizacion es una funcion de confiabilidad

Tactic Remote ahora incluye soporte completo para siete idiomas: ingles, chino (simplificado), japones, coreano, espanol, aleman y frances. Esto no es un anuncio de "pasamos las cadenas por una API de traduccion". La localizacion en una herramienta de desarrollo que maneja configuracion de red, salida de terminal y operaciones a nivel de sistema requiere un estandar diferente al de la traduccion de apps de consumo.

Este articulo cubre nuestro enfoque tecnico, los errores que nos ensenaron a tratar la localizacion como ingenieria de confiabilidad y lo que estamos observando en la adopcion internacional.

Los siete idiomas

Nuestra seleccion de idiomas fue impulsada por datos de usuarios y volumen de solicitudes durante la beta privada:

Priorizamos idiomas donde teniamos tanto demanda de usuarios como acceso a desarrolladores nativos que pudieran validar la precision tecnica. La localizacion de herramientas de desarrollo requiere experiencia en el dominio: traducir "session", "tunnel" o "hook" al japones requiere entender el significado tecnico del termino, no solo su definicion de diccionario.

Mas alla de la traduccion de cadenas

El enfoque estandar para la localizacion de iOS es sencillo: extraer cadenas visibles para el usuario en archivos .strings o .xcstrings, proporcionar traducciones y dejar que el sistema maneje la visualizacion. Hacemos esto, pero la ingenieria interesante esta en las capas debajo de la sustitucion de cadenas.

Manejo de entrada consciente del locale

El error que cambio nuestra filosofia de localizacion: los usuarios con locale aleman no podian introducir direcciones IP durante la configuracion.

El teclado de iOS en locale aleman utiliza por defecto una coma como separador decimal. Cuando un usuario con locale aleman toca el area de la tecla "." en el teclado numerico, obtiene una coma. Una direccion IPv4 como 192.168.1.100 se introducia como 192,168,1,100, lo cual nuestra validacion rechazaba como formato incorrecto.

Esto no es un error de traduccion. Es un error de comportamiento del locale. Las cadenas de la interfaz estaban correctamente traducidas, pero el mecanismo de entrada estaba roto por una suposicion sobre la disposicion del teclado. Lo solucionamos normalizando coma a punto en los campos de entrada de direcciones IP y presentando una configuracion de teclado personalizada que siempre muestra una tecla de punto para las entradas de direcciones de red.

Este unico error representaba aproximadamente el 23% de los fallos de configuracion entre usuarios con locale aleman antes de la correccion. Despues del despliegue, las tasas de completacion de la primera ejecucion en locale aleman igualaron la linea base en ingles en un ciclo de lanzamiento.

Pluralizacion y concordancia gramatical

La interpolacion de cadenas con conteos es una trampa clasica de localizacion. El ingles lo maneja simplemente: "1 session" vs. "2 sessions". Otros idiomas tienen reglas de plural mas complejas:

• El japones y el coreano no tienen plural gramatical: se usa la misma forma independientemente del numero.
• El frances pluraliza la mayoria de los sustantivos a partir de 2, pero algunas expresiones se comportan de manera diferente.
• Los compuestos en aleman pueden cambiar de forma segun el caso gramatical y la pluralidad.

Usamos el sistema de reglas de plural stringsdict de iOS, que soporta las categorias de plural CLDR (zero, one, two, few, many, other). Cada cadena visible para el usuario que incluye un conteo pasa por un formateo consciente de plurales en lugar de una concatenacion simple de cadenas.

Preparacion para escritura de derecha a izquierda

Ninguno de nuestros siete idiomas actuales requiere disposicion RTL, pero nuestra arquitectura de UI lo contempla. Todas las restricciones de diseno usan anclas leading/trailing en lugar de left/right. La alineacion de texto se establece en .natural. Esto significa que cuando agreguemos soporte para arabe o hebreo — ambos idiomas con comunidades de desarrolladores activas — el trabajo de disposicion sera minimo.

Localizacion de contenido MDX

El sitio web y la documentacion de Tactic Remote estan construidos con MDX. La localizacion del contenido de documentacion requirio una estrategia diferente a la localizacion de cadenas de la app.

Cada documento MDX puede tener variantes especificas de locale usando una convencion de sufijo en el nombre de archivo: product-update.mdx (ingles por defecto), product-update.zh-CN.mdx (chino), product-update.ja.mdx (japones), y asi sucesivamente. El enrutador de contenido detecta el idioma preferido del usuario y sirve la variante apropiada, con fallback a ingles cuando no existe una version localizada.

Este enfoque tiene una compensacion deliberada: no traducimos cada pagina de documentacion a cada idioma. Las guias de configuracion tecnica y las referencias de API permanecen en ingles porque contienen ejemplos de codigo, instrucciones de linea de comandos y valores de configuracion que son independientes del idioma. Concentramos el esfuerzo de localizacion en contenido donde las barreras linguisticas realmente bloquean la comprension: anuncios de producto, descripciones conceptuales y flujos de incorporacion.

Actualmente, el 34% de nuestro contenido MDX tiene al menos una variante en idioma no ingles. Priorizamos basandonos en el trafico de paginas y la correlacion con tickets de soporte: si una pagina genera preguntas de soporte desproporcionadamente desde un grupo linguistico especifico, esa pagina se localiza a continuacion.

El argumento de confiabilidad

Tratamos la localizacion como una funcion de confiabilidad por una razon especifica: un desarrollador que no puede completar la configuracion debido a un error de entrada relacionado con el locale esta en el mismo estado que un desarrollador que no puede conectarse debido a un error de red. El producto esta roto para el. Que la causa raiz sea "asumimos una disposicion de teclado en ingles" en lugar de "tenemos un error TCP" no cambia la experiencia del usuario.

Esta perspectiva tiene consecuencias practicas para nuestro proceso de ingenieria:

Matriz de pruebas especifica por locale. Nuestro CI ejecuta pruebas de ruta critica (flujo de configuracion, establecimiento de conexion, flujo de aprobacion) bajo seis configuraciones de locale no ingles. Una regresion en la entrada de IP en locale aleman se detectaria antes de la fusion.

Los errores de localizacion reciben triaje de severidad 1 cuando bloquean funcionalidad central. Una etiqueta mal traducida es cosmetica. Una falla de entrada dependiente del locale es un incidente de produccion.

Congelamiento de cadenas antes del lanzamiento. Congelamos las cadenas en ingles 72 horas antes de cada lanzamiento, dando a los traductores un objetivo estable. Las traducciones son validadas por desarrolladores nativos en el equipo, no solo por linguistas.

Adopcion internacional

Desde el lanzamiento del soporte multilingue, hemos visto cambios medibles en nuestra base de usuarios:

• Los usuarios con locale no ingles crecieron del 18% al 41% de los usuarios activos semanales en seis semanas.
• Los usuarios de chino (simplificado) son ahora el segundo grupo linguistico mas grande, representando el 15% de los activos semanales.
• Los usuarios japoneses tienen la mayor duracion promedio de sesion entre todos los grupos linguisticos: 52 minutos frente a 47 minutos en general.
• La tasa de completacion de configuracion en todos los locales esta ahora dentro de 2 puntos porcentuales de la linea base en ingles. Antes del trabajo de localizacion, algunos locales tenian tasas de completacion 15-20% inferiores al ingles.

La convergencia de la tasa de completacion de configuracion es la metrica que mas nos importa. Valida que la localizacion esta cerrando brechas de confiabilidad, no solo agregando etiquetas traducidas.

Proximos pasos

Estamos expandiendo el soporte de idiomas basandonos en los mismos criterios: demanda de usuarios mas acceso a revisores tecnicos nativos.

• Se estan evaluando idiomas adicionales en funcion de la demanda de usuarios y la disponibilidad de revisores tecnicos nativos.
• Estamos construyendo un flujo de trabajo de contribucion comunitaria para traducciones, con un proceso de revision que asegura la precision tecnica antes de la fusion.

Para detalles sobre como funcionan la deteccion de idioma y el fallback, consulta Arquitectura de Localizacion. Si deseas contribuir traducciones para un idioma no soportado, contactanos a traves de la pagina de Soporte.