Diseña un proceso de traducción
Conecta los cambios en el contenido de origen con traducciones listas para usar, con responsabilidades claras de revisión, entrega y recuperación.
Un proceso de traducción está completo cuando un cambio en el contenido de origen se convierte en contenido que puede usarse en el sistema que lo necesita. La generación es solo una parte. El flujo de trabajo también debe identificar la revisión correcta, recuperar sus traducciones de destino, conservar el trabajo aceptado y decidir qué se puede publicar.
Empieza por diseñar el proceso para un solo tipo de contenido real: catálogos de repositorios, artículos de un CMS o registros de aplicaciones. Cada tipo tiene responsables y formas de entrega diferentes. Un flujo de trabajo que trate los tres por igual puede ocultar las decisiones que determinan si un resultado se puede usar de forma segura.
Identifica quién es responsable de cada transición #
Un diseño para catálogos de repositorios podría contemplar estas decisiones:
| Transición | Decisión |
|---|---|
| El contenido de origen cumple los requisitos | Traducir el contenido de origen revisado correspondiente a un commit registrado, mediante un activador confiable que excluya las traducciones de destino generadas. |
| Comienza el trabajo | Usar el motor de localización, los idiomas, el formato y las versiones de referencia aceptadas que se hayan especificado; obtener la aprobación de la ejecución cuando se requiera. |
| Las traducciones de destino cumplen los criterios de aceptación | Los revisores asignados examinan los cambios requeridos y los casos sin resolver permanecen visibles. |
| Los resultados regresan | Los recursos descargados y validados se incorporan a una solicitud de incorporación de cambios de traducción. |
| El contenido llega a los lectores | La versión de la aplicación acepta el cambio y pasa las verificaciones de sus recursos. |
| Es necesario revertir un resultado | Restaurar los recursos que se sabe que funcionan correctamente y la configuración o las versiones de referencia correspondientes. |
Este diseño de flujo de trabajo es un ejemplo, no una configuración predeterminada del producto. Especifica el mecanismo concreto que hace cumplir cada decisión. Si una política del equipo no tiene un control automático, debe haber una persona designada para verificar su cumplimiento.
Elige las herramientas según sus responsabilidades #
Una integración nativa puede encargarse de los activadores del proveedor y de escribir los resultados en el sistema de origen con los permisos de su instalación. Un ejecutor de CLI se encarga de la recuperación local y de los commits. Quien hace las llamadas a la API se encarga de sus revisiones almacenadas y de activar los resultados. Elige los contratos admitidos que se ajusten a esas responsabilidades.
Studio mantiene la configuración y las decisiones de traducción; DevTools permite la ejecución programática y mediante archivos; Radar proporciona la evidencia disponible para medición e investigación. Son capacidades que puedes combinar, no pasos que debas adoptar obligatoriamente uno después de otro.
Consulta la documentación del proveedor elegido sobre sus modos manuales y automáticos, el manejo de borradores, los derechos y las consecuencias de la desconexión. Una conexión que publica en un CMS y otra que abre una solicitud de incorporación de cambios en un repositorio no tienen el mismo punto de aceptación.
Mantén intacta la relación entre revisiones #
Conserva juntos la identidad del contenido, la revisión de origen, el idioma de destino, la revisión o el artefacto de salida, la configuración y la aceptación. Decide qué sucede si llega una versión más reciente del contenido de origen mientras la traducción o la revisión está en curso. El resultado anterior no debe convertirse en el vigente solo porque termine después.
Decide dónde la reutilización conserva las traducciones de destino aceptadas y dónde se busca generar traducciones nuevas. La compatibilidad con el mismo formato no implica que las opciones sean idénticas en la API, la CLI y la aplicación. Conserva en el diseño la versión de referencia exacta y el comportamiento de forzado de quien realiza la llamada.
Planifica cómo abordar los casos sin resolver #
Define qué sucede si se rechazan los datos de entrada, falla una traducción de destino, se interrumpe la recuperación, hay que esperar una revisión, surge un conflicto local o se recibe una respuesta incierta. La siguiente acción debe recuperar el trabajo conocido conforme a su contrato, no empezar todo de nuevo porque se perdió un comprobante.
Algunas traducciones de destino completadas pueden quedar preparadas mientras otra sigue sin resolverse. Decide si la publicación las requiere todas o si puede usar una alternativa de forma deliberada. La política de revisión define las consecuencias de las decisiones pendientes y de los tiempos de espera agotados. Mantén los controles de ejecución en la herramienta responsable del trabajo, en lugar de inventar una acción universal de reintento.
Haz que la evidencia de calidad se pueda interpretar #
Define las preguntas relevantes para la publicación, también para las traducciones producidas fuera de Lingo.dev. Una medición puede identificar trabajo que necesita revisión sin convertirse en el sistema responsable del contenido aceptado ni de decidir su publicación.
El diseño de mediciones explica los criterios, la evidencia, los estados de respuesta y las poblaciones incluidas en los informes. Como parte del flujo de trabajo, designa a las personas que interpretarán esa evidencia y resolverán las dudas sobre el significado del contenido de origen.
Comprueba un ciclo completo antes de ampliar el alcance #
Lleva un cambio en el contenido de origen por las etapas de envío, recuperación, validación, revisión, entrega y uso. En una prueba segura, cambia el contenido de origen durante el procesamiento y simula un fallo en una traducción de destino. Verifica que la revisión vigente siga siendo identificable y que la recuperación conserve los resultados aceptados.
Usa una prueba del flujo de trabajo para registrar lo que realmente se ejecutó y lo que aún no se ha probado. El diseño está listo para ampliarse cuando otra persona que opere el proceso pueda explicar tanto cómo una traducción queda lista para usar como cómo restaurar el estado útil anterior.