Conserva las traducciones revisadas durante las actualizaciones
Mantén juntas las versiones de referencia del texto de origen y la traducción aceptada, elige el modo de actualización adecuado y comprueba exactamente qué ha cambiado.
Una traducción aceptada es un trabajo que merece la pena conservar. Cuando cambia un mensaje de origen, los mensajes que lo rodean pueden seguir siendo correctos. La reutilización permite conservarlos si el flujo de trabajo recibe las versiones de referencia adecuadas y aplica el comportamiento de fusión previsto.
La etiqueta «incremental» no basta para describir esa protección. Conserva el texto de origen anterior y la traducción aceptada, elige el contrato de actualización de quien realiza la llamada y examina las diferencias reales. Para una corrección conocida en el texto de destino, utiliza las actualizaciones de una sola clave; si el trabajo enviado se ha detenido, empieza por la recuperación.
Registra qué debe cambiar y qué debe conservarse #
Tomemos este texto de origen como ejemplo:
{
"retention": "Reports remain available for 30 days.",
"support": "Contact support",
"productName": "ExampleApp"
}La persona responsable del texto de origen cambia el periodo de retención a 60 días. Conserva el texto de origen anterior, el nuevo y la traducción revisada. El periodo indicado en la traducción debe cambiar; la redacción aceptada de support debe mantenerse. Mantener productName idéntico al texto de origen es un requisito distinto de conservar una frase revisada de la traducción.
Guarda la última revisión aceptada de la traducción, incluidos los cambios locales realizados desde la descarga y su justificación. Puede que la versión de referencia del servidor y el texto de destino del árbol de trabajo ya no tengan el mismo contenido.
Usa la planificación habitual de cambios incrementales cuando cambie el texto de origen #
En la CLI actual, la ejecución habitual de lingo push --wait utiliza el estado registrado del texto de origen y los textos de destino para planificar los cambios. Mantén la configuración, el texto de origen, las traducciones aceptadas y .lingo/lock.json bajo control de versiones. Eliminar el Lockfile altera la planificación; no es una simple actualización sin consecuencias.
--backfill-missing completa los archivos de destino que faltan, pero no todas las claves que faltan o han cambiado dentro de los archivos existentes. Los patrones de origen pasados como argumentos posicionales utilizan una planificación de alcance limitado con un comportamiento de reutilización distinto. --force regenera los destinos seleccionados que están en archivos separados y puede sustituir el texto aceptado; los catálogos XCStrings compartidos pueden seguir reutilizando sus traducciones integradas. Consulta la Referencia de Push para elegir la opción adecuada antes de solicitar la sustitución.
Revisa el alcance y, cuando resulte útil, haz una estimación antes de ejecutar la operación a gran escala. Tras recuperar el resultado, compara el valor modificado y los valores aceptados que lo rodean. Comprueba qué se ha conservado a partir del resultado, no de la etiqueta de la ejecución.
Distingue entre bloquear el texto de origen y conservar la traducción #
Una clave bloqueada, en los formatos que lo admiten, copia el texto de origen en el de destino. Una clave preservada mantiene un valor de destino existente. Por tanto, bloquear un mensaje revisado en francés puede sustituirlo por el texto en inglés; no protege la redacción en francés.
Los controles de claves dependen del formato. Excluir una clave de la salida es otra operación distinta. Un valor cuyos datos de origen hayan cambiado no debe conservarse de forma incondicional, ya que podría mantener un significado obsoleto.
Concilia las correcciones locales al recuperar los resultados #
Guarda las correcciones existentes antes de enviar una actualización. El texto de destino exacto que captura push puede sustituirse como parte de esa actualización. Para detectar cambios realizados después del envío, omite --wait y revisa lingo pull --dry-run. Pull compara los textos de destino locales con el texto de destino capturado y los hashes registrados, y puede negarse a sobrescribir cambios posteriores; la descarga directa desde push --wait no realiza esta nueva comprobación.
Si hay un conflicto, compara la corrección local, el texto de destino registrado y el resultado recibido con las revisiones de origen correspondientes. Conserva las correcciones que sigan siendo válidas mediante el proceso habitual de revisión. Utiliza lingo pull --force solo después de guardar el trabajo local y decidir expresamente que quieres sustituirlo. Forzar la operación evita la protección; no elige la redacción correcta.
En los catálogos compartidos de Apple, conserva el archivo completo y comprueba los idiomas que no se han modificado. No elimines un archivo que contenga el texto de origen y varios idiomas como si fuera un archivo de destino desechable.
Acepta la nueva versión de referencia tras revisarla #
En el ejemplo, comprueba que el nuevo texto de destino indique 60 días, que se haya conservado el valor de support y que productName se comporte como se espera. Comprueba las variables y la estructura en el entorno de ejecución que las utiliza. La comparación identifica los cambios; la revisión lingüística determina si la nueva afirmación es correcta.
Conserva la traducción aceptada junto con su revisión de origen como siguiente versión de referencia. Si la corrección debe modificar las directrices futuras, toma esa decisión por separado en el glosario o en las reglas, en lugar de dar por hecho que un cambio aceptado enseña al motor de localización una nueva política.