Recopila traducciones para medirlas

Elige una fuente compatible y conserva el texto, las revisiones y el contexto que necesita una medición.

Puedes empezar a medir con las traducciones que tu equipo ya produce. Mantén el repositorio o el sistema de gestión de traducciones como el lugar donde se conserva el texto aceptado y elige cómo ponerlo a disposición de una comprobación.

La unidad de trabajo es una versión que puedas identificar. Si un mensaje cambia después de evaluarlo, la respuesta anterior sigue correspondiendo a la redacción anterior. Conservar juntas las revisiones de origen y de destino permite al equipo consultar la evidencia en lugar de reconstruirla a partir del contenido más reciente.

Elige la fuente para tu flujo de trabajo #

Punto de partidaCómo medirlo
Actividad de CrowdinConecta Crowdin, configura una medición de eventos y revisa el evento y la respuesta resultantes en Radar. Necesitas acceso a Radar para consultar sus pantallas.
Commits de GitHubConecta la GitHub App y configura las rutas de origen y de destino. Los cambios en las claves de localización compatibles de la rama predeterminada se convierten en eventos.
Centro de ayuda de ZendeskConecta Zendesk. Los cambios en los artículos publicados se convierten en eventos de origen o de traducción en sus respectivos idiomas.
Archivos de traducción localesUsa lingo score con un evaluador y un modelo configurados. Los resultados se guardan localmente, fuera del historial de eventos de Radar.
Traducciones de Lingo.devCada localización completada ya es un evento. Revisar traducciones de Lingo.dev explica cómo seleccionar motores, idiomas y una muestra.

Si usas otra fuente, comunícate con Lingo.dev para coordinar la recopilación de eventos antes de automatizar la entrega.

Recopila actividad de GitHub y Zendesk #

Para GitHub, instala la aplicación en el repositorio que quieras usar y conéctala a la organización de Lingo.dev. Incluye .lingo/config.json en un commit con el idioma de origen, los idiomas de destino y los patrones de los archivos de origen. Estas rutas permiten identificar qué cambios corresponden al texto de origen y cuáles a las traducciones. Revisa un evento después de que un commit en la rama predeterminada modifique una clave de localización configurada; un solo commit puede generar eventos para varias claves e idiomas.

La recopilación de GitHub lee archivos JSON, JSONC, YAML, YAML con una clave raíz, recursos de Android, .strings de Apple, ARB de Flutter, PHP y TypeScript. Cambios del repositorio explica cómo los cambios se convierten en eventos.

Para Zendesk, autoriza la conexión del centro de ayuda y habilita sus idiomas. Radar registra por idioma la actividad de los artículos publicados. Abre el evento y compara la identidad del artículo, el idioma y el texto con los datos de Zendesk. Recopilar actividad no activa por sí solo una sincronización de traducciones ni publica un nuevo artículo de destino.

Ambas conexiones conservan las traducciones aceptadas en su sistema original. La medición examina los eventos registrados, sin encargarse de la publicación.

Importa el historial del proveedor antes de medirlo #

Elige el historial del proveedor que necesitas:

  • GitHub: importa hasta los últimos 5,000 commits de la rama predeterminada del repositorio. Cada commit se lee con .lingo/config.json tal como se guardó en esa revisión. Los commits anteriores a la existencia de esa configuración no generan eventos.
  • Zendesk: importa las versiones publicadas actuales de los artículos, las secciones y las categorías existentes en cada idioma, con la fecha de su última actualización. Esta recopilación no incluye revisiones anteriores ni versiones en borrador.

Las nuevas conexiones de GitHub y Zendesk inician automáticamente una importación del historial. Consulta su progreso en la pestaña Configuración de la conexión. Para iniciar o reintentar una importación más adelante:

  1. En Studio, selecciona el repositorio o el centro de ayuda en Conectados y luego abre su pestaña Configuración.
  2. En Historial de commits para GitHub o Historial del centro de ayuda para Zendesk, selecciona Importar historial.
  3. Consulta el progreso de la importación, que muestra cuántos elementos del proveedor están en cola para su recopilación.
  4. Espera a que los eventos que quieras medir aparezcan en Radar → Registros y luego revisa sus fechas, idiomas y texto.

Si una medición se ejecuta sobre eventos de proveedores, su pestaña Evaluación retroactiva también ofrece la opción Importar eventos, con los repositorios de GitHub y los centros de ayuda de Zendesk conectados. El historial importado se recopila sin ejecutar mediciones. Una vez que aparezcan los eventos que necesitas, habilita la medición e inicia una evaluación histórica para el intervalo correspondiente.

Si aparecen más eventos importados después de la evaluación retroactiva, vuelve a ejecutarla con Solo eventos aún no medidos habilitado. Si la importación falla, consulta su progreso y vuelve a intentarlo desde la misma pestaña Configuración. Revisa la evaluación retroactiva de la medición y sus resultados por separado de la importación.

Conserva la comparación #

Conserva juntos el ID del sistema de origen, el ID del contenido, el idioma de destino y la revisión del texto de destino. Para comprobar el significado, agrega la revisión de origen correspondiente. Para medir una edición, conserva el borrador a partir del cual se produjo el texto de destino editado.

Por ejemplo, en tu propio registro de seguimiento, la combinación de delivery.promise, el idioma fr y la revisión 42 identifica una entrada específica del catálogo. La revisión 43 puede cambiar lo que se promete.

Registra quién o qué produjo la traducción cuando el flujo de trabajo proporcione ese dato: una persona, un modelo, un proveedor de traducción automática o la reutilización de una memoria de traducción. Si el origen es desconocido, regístralo como tal. Un usuario del proveedor que aprobó una traducción no es necesariamente la persona o el modelo que la escribió.

Proporciona evidencia para la pregunta elegida #

El criterio determina qué debes recopilar. Una comprobación ortográfica puede examinar solo el texto de destino. Una comprobación de significado necesita el texto de origen y su traducción correspondiente, con contexto para resolver ambigüedades. Una comprobación terminológica necesita el término aplicable y sus límites de uso. Una comprobación de marcadores de posición necesita las reglas que deben cumplir esos marcadores, mientras que la distancia de edición requiere el par real de borrador y texto de destino.

Si una traducción no tiene su revisión de origen, déjala entre los casos pendientes de evaluación de significado y obtén el texto de origen antes de evaluarla.

Verifica un evento recopilado #

  1. Configura la medición seleccionada antes de generar actividad de prueba en la fuente conectada.
  2. Busca el evento correspondiente. Compara su idioma, texto, procedencia y borrador disponible con tu propio registro.
  3. Abre la respuesta de la medición y lee el criterio junto al texto. Comprueba si la medición devolvió una respuesta, devolvió N/A o no se completó.
  4. Conserva los identificadores del evento y de la medición junto con las revisiones evaluadas. Aplica cualquier corrección aceptada en el sistema que mantiene el texto.

Si calculas la puntuación localmente, revisa el resultado guardado junto con los archivos de entrada y la configuración del evaluador; este método no crea un evento en Radar.

Para un flujo de trabajo recurrente, conserva un registro de lo que se seleccionó, recopiló y midió. Medir traducciones desde tu proceso automatizado explica la recopilación y la recuperación, incluidos los reintentos y las revisiones modificadas.