Triage für Jira-Übersetzungsprobleme
Mache aus gekennzeichnetem Jira-Feedback Engine-Vorschläge, führe für jede Änderung eine Prüfung durch und entscheide, welche verbundenen Inhalte neu übersetzt werden sollen.
Ein Übersetzungsproblem zeigt sich oft an einem sichtbaren Symptom: einem falschen Produktbegriff, einer englischen Schaltfläche auf einer übersetzten Seite oder einem Text, der nicht mehr in den verfügbaren Platz passt. Verbinde Jira, um dieses Feedback in die Warteschlange zu übernehmen. Dort kannst du für die ausgewählten Engines eine Prüfung der vorgeschlagenen Änderungen an Glossaren, Regeln und Markenstimmen durchführen.
Öffne in der Navigation von Studio 2.5 Studio 2.5 → Integrationen statt Einstellungen → Integrationen. Vorhandene Verbindungs- und Einrichtungslinks funktionieren weiterhin.
Wähle für jeden Vorschlag Anwenden oder Verwerfen. Entscheide nach dem Anwenden der Änderungen auf der Registerkarte Neu übersetzen des Tickets, welche verbundenen Inhalte neu generiert werden sollen.
Jira verbinden und das Problem beschreiben #
Die Integration unterstützt Jira Cloud, einschließlich Jira Service Management Cloud, und setzt den Enterprise-Tarif voraus. Informationen zur aktuellen Verfügbarkeit findest du unter Preise.
- Öffne Warteschlange → Einstellungen in der gewünschten Lingo.dev-Organisation.
- Wähle unter Triage-Quellen die Option Verbinden und autorisiere die Jira-Instanz über Atlassian OAuth. Kontoverbindungen verwaltest du unter Einstellungen → Integrationen.
- Kehre zu den Einstellungen der Warteschlange zurück und wähle für die Instanz Engines auswählen. Wähle die Lokalisierungs-Engines, die durch Vorgänge dieser Instanz geändert werden dürfen, und anschließend Speichern.
Für die Instanz muss mindestens eine Engine ausgewählt sein, damit ihre Vorgänge Vorschläge erzeugen. Beim Speichern der Auswahl werden auch bestehende offene Vorgänge mit dem Label lingo erfasst. Eine Instanz kann jeweils nur mit einer Organisation verbunden sein. Jira-Kommentare werden unter der Identität des Kontos veröffentlicht, das die Verbindung autorisiert hat. Verwende ein geeignetes gemeinsames Konto, wenn Kommentare dem Team gemeinsam zugeordnet werden sollen.
Das Verbinden der Instanz, die Auswahl ihrer Engines und das erneute Übersetzen setzen org:manage_integrations voraus. Zum Anwenden oder Verwerfen eines Vorschlags ist org:suggestion:edit zusammen mit Bearbeitungszugriff auf die zugehörige Engine erforderlich. Alternativ kann einem Organisationsmitglied ausdrücklich Zugriff auf diese Engine gewährt werden. Unter Berechtigungen für Vorschläge erfährst du, wie du Zugriff gewährst.
Gib im Vorgang genügend Informationen an, um das Problem untersuchen zu können:
- Die betroffene Sprache, den genauen Ausgangstext und den angezeigten Zieltext sowie deren Fundstelle oder Revision.
- Das erwartete Ergebnis und das beobachtete Problem. Füge bei einem Darstellungsproblem einen Screenshot oder Angaben zum verfügbaren Platz hinzu.
- Die betroffene Anwendung oder Lokalisierungs-Engine sowie bereits genehmigte Terminologieentscheidungen.
Zum Beispiel: „Im checkout von es-MX lautet der Ausgangstext der Schaltfläche ‚Place order‘, der angezeigte Zieltext ist in Revision X aber weiterhin auf Englisch.“ Der Bericht benennt eine nicht übersetzte Textstelle, ohne vorauszusetzen, dass ein Glossareintrag das Problem behebt.
Füge einem offenen Vorgang das Label lingo hinzu. Die Groß- und Kleinschreibung spielt dabei keine Rolle. Lingo.dev liest die Zusammenfassung, Beschreibung und Kommentare und schlägt Änderungen für die ausgewählten Engines der Instanz vor. Öffne die Warteschlange, zeige mit dem Filter Art die Einträge vom Typ Triage an und wähle das Ticket aus, um eine Prüfung der Vorschläge durchzuführen.
Auch Aktualisierungen eines Vorgangs mit diesem Label können ihn in die Warteschlange aufnehmen. Ist das Ticket bereits offen, bleibt seine aktuelle Vorschlagsrunde bestehen.
Die vorgeschlagene Korrektur auf das Problem abstimmen #
Lies die gemeldete Textstelle, bevor du einen Vorschlag anwendest. Manche Probleme erfordern gemeinsame Übersetzungsvorgaben, andere eine Änderung an der Anwendung oder der Auslieferung.
| Gemeldetes Problem | Was zu klären ist |
|---|---|
| Ein falscher Produktbegriff in einer Sprache | Der vorgesehene Begriff, das Sprachpaar und die Lokalisierungs-Engine, deren Glossar geändert werden soll. |
| Ein unerwartetes koreanisches Datumsformat | Ob der Wert übersetzter Text ist oder von einer Formatierungsfunktion der Anwendung erzeugt wird. |
| Deutscher Text ragt über ein Navigationselement hinaus | Ob eine kürzere Formulierung die Bedeutung bei der verfügbaren Breite erhalten kann oder das Layout der Komponente geändert werden muss. |
| Mehrere Sprachen zeigen den Ausgangstext an | Ob für jede Sprache Übersetzungen generiert, geladen und ausgewählt wurden. |
| API-Anfragen liefern 429 zurück | Ob das Problem überhaupt die Formulierung einer Übersetzung betrifft oder vielmehr ein API-Limit. |
Übertrage die Behebung eines fehlenden Katalogs, einer fehlerhaften Datumsformatierung oder eines Layoutfehlers den Verantwortlichen für die Anwendung. Ändere ein Glossar, eine Regel oder eine Markenstimme, wenn sich damit die im Bericht beschriebene Anforderung an die Formulierung erfüllen lässt.
Jeden Vorschlag anwenden oder verwerfen #
Öffne die Registerkarte Vorschläge des Tickets. Sieh dir bei jedem Vorschlag die Lokalisierungs-Engine, die Sprache, die Erklärung und die Zielressource an. Vorschläge können:
- Einen Glossarbegriff hinzufügen oder aktualisieren.
- Eine Übersetzungsregel hinzufügen oder aktualisieren.
- Eine Markenstimmen-Variation hinzufügen oder aktualisieren.
Wähle Anwenden, um die Änderung sofort zu speichern, oder Verwerfen, um die Vorgaben unverändert zu lassen. Achte auf doppelte oder widersprüchliche Vorgaben und sieh dir auch andere Engines an, die dieselbe Zielressource verwenden. Öffne nach dem Anwenden den gespeicherten Begriff, die Regel oder die Markenstimmen-Variation, um die Änderung zu kontrollieren.
Sobald die Generierung abgeschlossen ist und über die Vorschläge des Tickets entschieden wurde, veröffentlicht Lingo.dev einen Jira-Kommentar mit einer Zusammenfassung der Ergebnisse und einem Link zur Warteschlange. Wenn keine Engine eine Änderung vorschlägt, steht dies in der Zusammenfassung. Schließe den Jira-Vorgang nach der Kontrolle des Ergebnisses gemäß dem üblichen Ablauf deines Teams.
Entscheiden, ob bestehende Übersetzungen aktualisiert werden sollen #
Öffne nach dem Anwenden eines Vorschlags die Registerkarte Neu übersetzen des Tickets. Dort findest du die betroffenen Integrationen für GitHub, Zendesk und Payload CMS sowie die Zielsprachen, auf die sich die Änderungen beziehen.
Wähle die Integrationen aus, die du aktualisieren möchtest, kontrolliere die aufgeführten Sprachen und wähle Neu übersetzen. Dadurch wird der gesamte konfigurierte Umfang jeder ausgewählten Integration in diesen Sprachen neu generiert. Dabei können akzeptierte manuelle Bearbeitungen ersetzt werden, und es fällt der übliche Übersetzungsverbrauch an.
Verfolge jede Ausführung und sieh dir das Ergebnis am jeweiligen Ziel an: den Repository-Diff oder Pull Request bei GitHub oder die übersetzten Inhalte und den Veröffentlichungsstatus bei Zendesk oder Payload. Führe die Prüfung und anschließend den Merge beziehungsweise die Veröffentlichung gemäß dem üblichen Ablauf durch. Du kannst die erneute Übersetzung auch auf später verschieben; die angewendeten Vorgaben bleiben gespeichert.
Triage wieder aufnehmen oder beenden #
Wenn du das Label lingo entfernst oder das Issue schließt oder löschst, wird das zugehörige Warteschlangen-Ticket geschlossen. Ausstehende Vorschläge, auf die kein anderes offenes Ticket verweist, werden verworfen. Bereits übernommene Änderungen bleiben gespeichert. Wenn du ein Issue mit diesem Label erneut öffnest oder das Label nach dem Schließen des Tickets wieder zu einem offenen Issue hinzufügst, startet eine neue Runde mit Vorschlägen. Der bisherige Verlauf bleibt dabei erhalten.
Wenn ein erwartetes Ticket fehlt, vergewissere dich, dass der Vorgang offen ist, das Label lingo trägt und zu einer verbundenen Instanz gehört, für die unter Warteschlange → Einstellungen Engines ausgewählt sind. Sieh dir den Tarif der Organisation und den Verbindungsstatus an. Bleibt ein Ticket nach Wiederherstellung des Verbindungszugriffs weiterhin in Bearbeitung, teile seinen Link mit dem Lingo.dev-Support.
Verwalte die Kontoautorisierung und das Trennen der Verbindung unter Einstellungen → Integrationen. Damit neue Vorgänge keine Vorschläge mehr erzeugen, die Verbindung aber bestehen bleibt, entferne unter Warteschlange → Einstellungen alle ausgewählten Engines und speichere die Änderung. Beende bestehende Tickets separat in Jira.
Jira-Webhooks werden regelmäßig nach einem Zeitplan erneuert. Wenn keine Aktualisierungen mehr eintreffen, kontrolliere die Autorisierung der Instanz und den Verbindungszustand. Verbinde die Instanz erneut, wenn der Zugriff wiederhergestellt werden muss. Widerrufe die OAuth-Berechtigung separat, wenn der Zugriff beim Anbieter beendet werden soll. Bestehende Kommentare, angewendete Vorgaben und abgeschlossene Übersetzungsergebnisse bleiben erhalten.