Clasificación de problemas de traducción en Jira
Convierte los comentarios etiquetados de Jira en sugerencias para el motor, revisa cada cambio y elige qué contenido conectado volver a traducir.
Un problema de traducción suele manifestarse de forma 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 puedes revisar los cambios propuestos al 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 existentes 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 el problema #
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 clasificación, selecciona Conectar y autoriza el sitio de Jira mediante OAuth de Atlassian. Las conexiones de cuentas se administran 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 sus incidencias podrán modificar y luego 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 toman en cuenta las incidencias abiertas que ya tengan la etiqueta lingo. Un sitio solo puede pertenecer a una organización conectada a la vez. Los comentarios en Jira se publican con la identidad de quien autorizó 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 requiere org:manage_integrations. Para aplicar o descartar una sugerencia, se requiere org:suggestion:edit junto con acceso de edición a su motor, o un permiso explícito para ese motor otorgado a un miembro de la organización. Permisos de sugerencias explica cómo otorgar acceso.
Incluye suficiente información en la incidencia para poder investigarla:
- El idioma afectado, el texto de origen exacto y el texto de destino que se muestra, junto con su ubicación o revisión.
- El resultado esperado y el problema observado. Si el problema es de presentación, incluye una captura de pantalla o indica la limitación de espacio.
- La aplicación o el motor de localización involucrado, además de cualquier decisión terminológica ya aprobada.
Por ejemplo: “En el checkout 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 reporte identifica un caso sin traducir, sin dar por hecho que una entrada del glosario sea la solución.
Agrega la etiqueta lingo a una incidencia abierta; no se distingue entre mayúsculas y minúsculas. 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 Clasificación y selecciona el ticket para revisar sus sugerencias.
Las actualizaciones de una incidencia etiquetada también pueden llevarla a La Cola. Si el ticket ya está abierto, conserva su ronda actual de sugerencias.
Comprueba que la solución propuesta resuelva el problema #
Lee el caso reportado antes de aplicar una sugerencia. Algunos problemas requieren pautas de traducción compartidas; otros, un cambio en la aplicación o en la entrega.
| Problema reportado | Qué 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 cambiar. |
| 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 no cabe en 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 429 | Si el problema tiene que ver con la redacción de la traducción y no con un límite de la API. |
Si falta un catálogo o hay un defecto en el formato de fechas o en el diseño, asigna la corrección al 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 señalada en el reporte.
Aplica o descarta cada sugerencia #
Abre la pestaña Sugerencias del ticket. En cada propuesta, revisa el motor de localización, el idioma, la explicación y el recurso de destino. Las sugerencias pueden:
- Agregar o actualizar un término del glosario.
- Agregar o actualizar una regla de traducción.
- Agregar o actualizar una variación de voz de marca.
Elige Aplicar para guardar el cambio de inmediato o Descartar para mantener las pautas sin cambios. Comprueba si hay pautas 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 variación de voz que guardaste para verificarlo.
Cuando termina la generación y se ha decidido qué hacer con todas las sugerencias del ticket, Lingo.dev publica un comentario en Jira con un resumen de los resultados y un enlace a La Cola. Si ningún motor propone un cambio, el resumen lo indica. Después de comprobar el resultado, cierra la incidencia de Jira siguiendo el proceso habitual de tu equipo.
Decide si quieres actualizar las traducciones existentes #
Después de aplicar una sugerencia, abre la pestaña Volver a traducir del ticket. Allí aparecen las integraciones de GitHub, Zendesk y Payload CMS afectadas, junto con los idiomas de destino a los que corresponden los cambios.
Selecciona las integraciones que quieres actualizar, revisa los idiomas indicados y elige Volver a traducir. Esto regenera todo el contenido dentro del alcance configurado de cada integración seleccionada en esos idiomas. Puede reemplazar las ediciones humanas aceptadas y se contabiliza como uso normal de traducción.
Da seguimiento a 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 los cambios e intégralos o publícalos siguiendo el proceso habitual. Puedes volver a traducir más adelante; las pautas aplicadas quedan guardadas.
Resuelve problemas o finaliza la clasificación #
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 ningún otro ticket abierto haga referencia. Los cambios aplicados se mantienen guardados. Si vuelves a abrir una incidencia que aún tiene la etiqueta, o vuelves a agregar la etiqueta a una incidencia abierta después de que se cierre su ticket, se inicia una nueva ronda de sugerencias y se conserva 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. Revisa el plan de la organización y el estado de la conexión. Si un ticket sigue en procesamiento después de restablecer el acceso de la conexión, comparte su enlace con el equipo de soporte de Lingo.dev.
Administra la autorización y la desconexión de la cuenta en Configuración → Integraciones. Para evitar que las nuevas incidencias generen sugerencias sin eliminar la conexión, desmarca todos sus motores en La Cola → Configuración y guarda. Finaliza los tickets existentes en Jira por separado.
Los webhooks de Jira se renuevan periódicamente. Si dejan de llegar actualizaciones, revisa la autorización del sitio y el estado de la conexión; vuelve a conectar cuando sea necesario restablecer el acceso. Revoca la autorización OAuth por separado cuando deba finalizar el acceso al proveedor. Los comentarios existentes, las pautas aplicadas y los resultados de traducción completados se conservan.