La lista de verificación de confiabilidad de traducción de Contentful

Una traducción puede ser lingüísticamente excelente y aun así fracasar en el lanzamiento.

Puede haberse utilizado la instantánea de origen incorrecta. La estructura de rich-text puede haber cambiado. Es posible que un valor revisado no haya llegado a Contentful. La actualización puede estar presente pero sin publicar. La confiabilidad proviene de proteger todo el recorrido, no de optimizar una sola respuesta del modelo.

Antes de la traducción

Comienza con un límite de origen claro.

• identifica la entrada y el entorno exactos de Contentful
• captura los idiomas de origen y destino
• carga solo los campos aptos para traducción
• preserva los enlaces, inserciones, marcas y la estructura no traducible
• registra el modelo, el prompt y las reglas terminológicas
• muestra si se incluyen campos de origen vacíos

Si el alcance de la solicitud es ambiguo antes de la generación, cada fase posterior hereda esa ambigüedad.

Durante la generación

La llamada al proveedor debe ser observable y lo bastante repetible como para respaldar la revisión.

Valida que la respuesta contenga todos los campos esperados y los marcadores protegidos. Rechaza la salida estructurada con formato incorrecto en lugar de intentar guardar las partes que parecen plausibles.

Los reintentos deben reutilizar el mismo alcance de solicitud. Si se selecciona un modelo o prompt diferente, trata el resultado como un nuevo intento para que los revisores puedan entender por qué cambió el borrador.

Durante la revisión

La revisión necesita tres estados uno al lado del otro:

1. el valor de origen usado para la traducción
2. el valor actual de destino en Contentful
3. el borrador localizado propuesto

Esto revela datos de origen desactualizados y protege el trabajo de localización existente.

Para rich text, revisa tanto el lenguaje como la jerarquía. Abre la vista previa del CMS antes de aprobar cuando el diseño, los enlaces o el contenido incrustado afecten la página.

Las ediciones realizadas por el revisor deben pasar a formar parte del historial del borrador guardado en lugar de desaparecer en un envío final.

Durante el envío

Escribe el cambio más pequeño posible.

Envía solo los campos aprobados del idioma de destino. Vuelve a obtener la entrada actual de Contentful, preserva los valores no relacionados y usa la versión más reciente de la entrada. Si el mismo campo de destino cambió después de que comenzó la revisión, detente para tomar una decisión en lugar de sobrescribirlo automáticamente.

Registra qué campos aceptó Contentful y cuándo. Una respuesta exitosa de la API debe corresponder a un estado de solicitud duradero antes de que la interfaz anuncie la finalización.

Durante la publicación

Enviar y publicar son resultados separados.

Confirma que la entrada sea apta para el modo de publicación configurado y que el usuario tenga permiso para publicar. Si la publicación es automática, mantén su fallo independiente del éxito de la traducción y del envío.

La solicitud debe mostrar claramente "enviado, publicación fallida" en lugar de colapsar todo el flujo de trabajo en un fallo genérico.

Durante la recuperación

Los sistemas confiables asumen que los proveedores agotan el tiempo de espera, las redes se interrumpen y las versiones del CMS entran en conflicto.

• reintenta los errores transitorios dentro de límites acotados
• reanuda desde la fase fallida
• conserva intactas las traducciones y los envíos exitosos
• expone el error accionable más reciente
• permite la cancelación cuando el trabajo activo puede detenerse de forma segura
• hace que el estado final sea recuperable mediante sondeo incluso sin eventos en tiempo real

La recuperación debe preservar el trabajo, no reiniciarlo por reflejo.

La conclusión

No existe una única función de confiabilidad para la traducción en Contentful.

La confianza surge de salvaguardas específicas en cada límite: alcance explícito, estructura protegida, estados de revisión comparables, escrituras mínimas, estado de publicación separado y recuperación consciente de la fase. Cuando esos controles funcionan juntos, los equipos pueden avanzar rápido sin tratar cada lanzamiento multilingüe como una apuesta.