Conserva las traducciones revisadas durante las actualizaciones
Mantén juntas las versiones de referencia del texto fuente y de la traducción aceptada, elige el modo de actualización adecuado y verifica exactamente qué cambió.
Una traducción aceptada representa un trabajo que vale la pena conservar. Cuando cambia un mensaje del texto fuente, los mensajes cercanos 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 combinación previsto.
El término “incremental” por sí solo no describe esa protección. Conserva el texto fuente anterior y la traducción aceptada, elige el contrato de actualización de quien realiza la llamada y revisa las diferencias reales. Para corregir un valor específico de la traducción, usa actualizaciones de una sola clave; si el trabajo enviado se detuvo, comienza con la recuperación.
Registra qué debe cambiar y qué debe conservarse #
Considera este ejemplo de texto fuente:
{
"retention": "Reports remain available for 30 days.",
"support": "Contact support",
"productName": "ExampleApp"
}La persona responsable del texto fuente cambia el período de retención a 60 días. Conserva el texto fuente anterior, el nuevo y la traducción revisada. El período debe cambiar en la traducción, pero la redacción aceptada de support debe mantenerse. Mantener productName idéntico al texto fuente es un requisito distinto de conservar una frase revisada en 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. Es posible que la versión de referencia del servidor y la traducción del árbol de trabajo ya no tengan el mismo contenido.
Usa la planificación habitual de cambios incrementales cuando cambie el texto fuente #
El lingo push --wait habitual de la CLI actual usa el estado registrado del texto fuente y las traducciones para planificar los cambios. Mantén la configuración, el texto fuente, 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 traducción faltantes, no todas las claves faltantes o modificadas dentro de los archivos existentes. Los patrones del texto fuente pasados como argumentos posicionales usan una planificación de alcance limitado con un comportamiento de reutilización diferente. --force regenera las traducciones seleccionadas que están en archivos separados y puede reemplazar el texto aceptado; los catálogos XCStrings compartidos aún pueden reutilizar sus traducciones integradas. Consulta la Referencia de Push para elegir la opción adecuada antes de solicitar un reemplazo.
Revisa el alcance y, cuando sea útil, realiza una estimación antes de ejecutar la operación a gran escala. Después de obtener los resultados, compara el valor modificado con los valores aceptados cercanos. Confirma qué se conservó a partir del resultado, no de la etiqueta de la ejecución.
Distingue el bloqueo del texto fuente de la conservación de la traducción #
Una clave bloqueada, cuando el formato lo admite, copia el texto fuente en la traducción. Una clave conservada mantiene un valor existente en la traducción. Por eso, bloquear un mensaje revisado en francés puede reemplazarlo por el texto en inglés; no protege la redacción en francés.
Los controles de claves dependen del formato. Excluir una clave del resultado es otra operación distinta. Si los datos del texto fuente cambiaron, el valor correspondiente no debe conservarse de forma incondicional, ya que podría mantener un significado obsoleto.
Concilia las correcciones locales al obtener los resultados #
Guarda las correcciones existentes antes de enviar una actualización. La versión exacta de la traducción capturada por push puede reemplazarse como parte de esa actualización. Para detectar cambios realizados después del envío, omite --wait y luego revisa lingo pull --dry-run. Pull compara las traducciones locales con la traducción capturada y los hashes registrados, y puede impedir que se sobrescriban cambios posteriores; la descarga directa desde push --wait no realiza esta nueva comprobación.
Si hay un conflicto, compara la corrección local, la traducción registrada y el resultado entrante con las revisiones correspondientes del texto fuente. Conserva las correcciones que sigan siendo válidas mediante el proceso habitual de revisión. Usa lingo pull --force solo después de guardar el trabajo local y decidir expresamente que quieres reemplazarlo. Forzar el reemplazo omite la protección; no elige la redacción correcta.
Para los catálogos compartidos de Apple, conserva el archivo completo y revisa los idiomas que no se modificaron. No elimines un archivo que contiene el texto fuente y varios idiomas como si fuera un archivo de traducción desechable.
Acepta la nueva versión de referencia después de revisarla #
En el ejemplo, verifica que la nueva traducción indique 60 días, que se conserve el valor de support y que productName se comporte como se esperaba. 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 la revisión correspondiente del texto fuente como la siguiente versión de referencia. Si la corrección debe modificar las pautas futuras, toma esa decisión por separado en el glosario o en las reglas, en lugar de suponer que una sola edición aceptada le enseña una nueva política al motor de localización.