Triaje de traducciones con Jira
Convierte los comentarios etiquetados de Jira en sugerencias para los motores, revisa cada cambio y elige qué contenido conectado volver a traducir.
Una incidencia de traducción suele señalar un síntoma visible: un término de producto incorrecto, un botón en inglés en una pantalla traducida o un texto que ya no cabe. Conecta Jira para llevar esos comentarios a La Cola, donde podrás revisar los cambios propuestos en el glosario, las reglas y la voz de marca de los motores que elijas.
En el menú de navegación de Studio 2.5, abre Studio 2.5 → Integraciones en lugar de Configuración → Integraciones. Los enlaces de conexión y configuración que ya utilizas siguen funcionando.
Elige Aplicar o Descartar para cada sugerencia. Después de aplicar los cambios, usa la pestaña Volver a traducir del ticket para decidir qué contenido conectado regenerar.
Conecta Jira y describe la incidencia #
La integración es compatible con Jira Cloud, incluido Jira Service Management Cloud, y está disponible con el plan Enterprise. Consulta los precios para conocer la disponibilidad actual.
- Abre La Cola → Configuración en la organización de Lingo.dev correspondiente.
- En Fuentes de triaje, selecciona Conectar y autoriza el sitio de Jira mediante OAuth de Atlassian. Las conexiones de cuentas se gestionan en Configuración → Integraciones.
- Vuelve a la configuración de La Cola y selecciona Elegir motores para el sitio. Elige los motores de localización que las incidencias de ese sitio podrán modificar y, después, selecciona Guardar.
El sitio debe tener al menos un motor seleccionado para que sus incidencias generen sugerencias. Al guardar la selección, también se recogen las incidencias abiertas que ya tengan la etiqueta lingo. Un sitio solo puede pertenecer a una organización conectada a la vez. Los comentarios de Jira se publican con la identidad de quien autoriza la conexión; usa una cuenta compartida adecuada si el equipo necesita que los comentarios se atribuyan a una identidad compartida.
Para conectar el sitio, elegir sus motores y volver a traducir se necesita org:manage_integrations. Para aplicar o descartar una sugerencia se necesita org:suggestion:edit junto con acceso de edición a su motor, o un permiso explícito de acceso a ese motor para un miembro de la organización. En Permisos de sugerencias se explica cómo conceder acceso.
Incluye en la incidencia información suficiente para investigarla:
- El idioma afectado, el texto exacto de origen y el texto de destino que se muestra, así como su ubicación o revisión.
- El resultado esperado y el problema observado. Incluye una captura de pantalla o indica la limitación de espacio si se trata de un problema de presentación.
- La aplicación o el motor de localización implicado, junto con cualquier decisión terminológica ya aprobada.
Por ejemplo: «En el proceso de compra de es-MX, el botón de origen dice “Realizar pedido”, pero el texto de destino que se muestra sigue en inglés en la revisión X». El informe identifica un caso sin traducir sin dar por hecho que una entrada del glosario sea la solución.
Añade la etiqueta lingo, que no distingue entre mayúsculas y minúsculas, a una incidencia abierta. Lingo.dev lee su resumen, descripción y comentarios y propone cambios para los motores seleccionados del sitio. Abre La Cola, usa el filtro Tipo para mostrar los elementos de Triaje y selecciona el ticket para revisar sus sugerencias.
Las actualizaciones de una incidencia etiquetada también pueden incorporarla a La Cola. Si el ticket ya está abierto, conserva su ronda actual de sugerencias.
Comprueba que la solución propuesta se ajusta al problema #
Lee el caso descrito antes de aplicar una sugerencia. Algunos problemas necesitan directrices de traducción compartidas; otros requieren un cambio en la aplicación o en la entrega del contenido.
| Problema comunicado | Qué hay que determinar |
|---|---|
| Un término de producto incorrecto en un idioma | El término correcto, el par de idiomas y el motor de localización cuyo glosario debe modificarse. |
| Un formato de fecha inesperado en coreano | Si el valor es texto traducido o lo genera una función de formato de la aplicación. |
| El texto en alemán se sale de un control de navegación | Si una redacción más concisa puede conservar el significado dentro del ancho disponible o si el componente necesita un cambio de diseño. |
| Varios idiomas muestran el texto de origen | Si las traducciones se generaron, cargaron y seleccionaron para cada idioma. |
| El tráfico de la API devuelve el código 429 | Si la incidencia está realmente relacionada con la redacción de la traducción y no con un límite de la API. |
Si falta un catálogo, hay un problema con la función de formato de fechas o existe un defecto de diseño, asigna la corrección a la persona responsable de la aplicación. Recurre a un cambio en el glosario, las reglas o la voz de marca cuando resuelva la necesidad de redacción indicada en el informe.
Aplica o descarta cada sugerencia #
Abre la pestaña Sugerencias del ticket. Para cada propuesta, comprueba el motor de localización, el idioma, la explicación y el recurso de destino. Las sugerencias pueden:
- Añadir o actualizar un término del glosario.
- Añadir o actualizar una regla de traducción.
- Añadir o actualizar una variante de voz de marca.
Elige Aplicar para guardar el cambio de inmediato o Descartar para dejar las directrices como están. Comprueba si hay directrices duplicadas o contradictorias y revisa los demás motores que compartan el recurso de destino. Después de aplicar el cambio, abre el término, la regla o la variante de voz de marca que hayas guardado para comprobar el resultado.
Una vez finalizada la generación y decidido qué hacer con las sugerencias del ticket, Lingo.dev publica un comentario en Jira que resume los resultados e incluye un enlace a La Cola. Si ningún motor propone un cambio, el resumen lo indica. Tras comprobar el resultado, cierra la incidencia de Jira siguiendo el proceso habitual de tu equipo.
Decide si actualizar las traducciones existentes #
Después de aplicar una sugerencia, abre la pestaña Volver a traducir del ticket. En ella se enumeran las integraciones de GitHub, Zendesk y Payload CMS afectadas y los idiomas de destino a los que afectan los cambios.
Selecciona las integraciones que quieras actualizar, comprueba los idiomas indicados y elige Volver a traducir. Esto regenera todo el contenido incluido en el alcance configurado de cada integración seleccionada en esos idiomas. Puede sustituir las modificaciones humanas aceptadas y se contabiliza como uso normal de traducción.
Sigue cada ejecución y revisa el resultado en su destino: las diferencias del repositorio o la solicitud de incorporación de cambios en GitHub, o el contenido traducido y el estado de publicación en Zendesk o Payload. Revisa e incorpora los cambios o publica siguiendo el proceso habitual. Puedes dejar la retraducción para más tarde; las directrices aplicadas quedan guardadas.
Reanuda o finaliza el triaje #
Al quitar la etiqueta lingo, cerrar la incidencia o eliminarla, se cierra su ticket en La Cola y se descartan las sugerencias pendientes a las que no haga referencia ningún otro ticket abierto. Los cambios aplicados se mantienen guardados. Si vuelves a abrir una incidencia que conserva la etiqueta, o vuelves a añadir la etiqueta a una incidencia abierta después de que se haya cerrado su ticket, se inicia una nueva ronda de sugerencias sin perder el historial anterior.
Si no aparece un ticket que esperabas ver, comprueba que la incidencia esté abierta, tenga la etiqueta lingo y pertenezca a un sitio conectado con motores seleccionados en La Cola → Configuración. Comprueba el plan de la organización y el estado de la conexión. Si un ticket sigue procesándose después de restablecer el acceso de la conexión, comparte su enlace con el equipo de soporte de Lingo.dev.
Gestiona la autorización y la desconexión de la cuenta en Configuración → Integraciones. Para impedir que las nuevas incidencias generen sugerencias sin eliminar la conexión, desmarca los motores seleccionados en La Cola → Configuración y guarda los cambios. Finaliza los tickets existentes en Jira por separado.
Los webhooks de Jira se renuevan periódicamente. Si dejan de llegar actualizaciones, comprueba la autorización del sitio y el estado de la conexión; vuelve a conectarlo cuando sea necesario restablecer el acceso. Revoca la autorización de OAuth por separado cuando quieras poner fin al acceso al proveedor. Los comentarios existentes, las directrices aplicadas y los resultados de traducción completados se conservan.