Eine Übersetzungspipeline entwerfen
Aus Quelländerungen nutzbare Übersetzungen machen – mit klaren Zuständigkeiten, Prüfung, Bereitstellung und Wiederherstellung.
Eine Übersetzungspipeline ist erst vollständig, wenn aus einer Quelländerung nutzbarer Inhalt in dem System wird, das ihn benötigt. Die Generierung ist nur ein Teil davon. Der Workflow muss auch die richtige Revision ermitteln, die zugehörigen Zielübersetzungen abrufen, akzeptierte Arbeit erhalten und festlegen, was veröffentlicht werden darf.
Beginnen Sie mit einer konkreten Art von Inhalten: Repository-Katalogen, CMS-Artikeln oder Anwendungsdatensätzen. Für sie gelten unterschiedliche Zuständigkeiten und Bereitstellungsabläufe. Ein Workflow, der alle drei gleich behandelt, kann genau die Entscheidungen verdecken, von denen die sichere Nutzung eines Ergebnisses abhängt.
Zuständigkeiten für jeden Übergang festlegen #
Ein Workflow für Repository-Kataloge könnte folgende Entscheidungen vorsehen:
| Übergang | Entscheidung |
|---|---|
| Quelle wird zur Übersetzung zugelassen | Quellinhalte nach abgeschlossener Prüfung auf dem Stand eines dokumentierten Commits übersetzen – ausgelöst durch einen vertrauenswürdigen Trigger, der generierte Zielübersetzungen ausschließt. |
| Arbeit beginnt | Die ausdrücklich festgelegte Lokalisierungs-Engine, die Sprachen, das Format und die akzeptierten Ausgangsstände verwenden; eine Freigabe für den Lauf einholen, sofern erforderlich. |
| Zielübersetzungen können akzeptiert werden | Die zugewiesenen Prüfer sehen sich die erforderlichen Änderungen an; ungeklärte Fälle bleiben sichtbar. |
| Ausgabe wird zurückgeführt | Heruntergeladene und validierte Ressourcen werden in einen Übersetzungs-Pull Request aufgenommen. |
| Inhalte erreichen die Leserschaft | Die Anwendungsversion übernimmt die Änderung und besteht die Ressourcenprüfungen. |
| Ein Ergebnis muss rückgängig gemacht werden | Nachweislich funktionierende Ressourcen und die zugehörige Konfiguration oder die entsprechenden Ausgangsstände wiederherstellen. |
Dieser Workflow-Entwurf dient als Beispiel und ist keine Standardeinstellung des Produkts. Benennen Sie für jede Entscheidung den Mechanismus, der sie tatsächlich durchsetzt. Wird eine Teamrichtlinie nicht automatisch kontrolliert, muss eine konkrete Person für die Kontrolle ihrer Einhaltung zuständig sein.
Werkzeuge nach ihren Zuständigkeiten auswählen #
Eine native Integration kann im Rahmen ihrer Installationsberechtigungen die Trigger des Anbieters und das Zurückschreiben übernehmen. Ein CLI-Runner ist für den lokalen Abruf und die Commits zuständig. Ein API-Aufrufer verantwortet seine gespeicherten Revisionen und die Aktivierung der Ausgabe. Wählen Sie die unterstützten Schnittstellenvereinbarungen, die zu diesen Zuständigkeiten passen.
Studio verwaltet die Übersetzungskonfiguration und die Entscheidungen; DevTools ermöglicht die programmgesteuerte und dateibasierte Ausführung; Radar liefert die verfügbaren Mess- und Untersuchungsdaten. Diese Funktionen lassen sich kombinieren – sie sind keine Einführungsschritte, die zwingend aufeinander folgen müssen.
Informieren Sie sich über die manuellen und automatischen Modi des gewählten Anbieters, den Umgang mit Entwürfen, die Nutzungsberechtigungen und die Folgen einer Trennung. Eine Verbindung, die Inhalte in einem CMS veröffentlicht, hat einen anderen Freigabepunkt als eine, die einen Pull Request im Repository öffnet.
Den Zusammenhang zwischen Revisionen bewahren #
Halten Sie Inhaltsidentität, Quellrevision, Zielsprache, Ausgaberevision oder Artefakt, Konfiguration und Freigabe zusammen fest. Legen Sie fest, was geschieht, wenn während einer Übersetzung oder Prüfung ein neuerer Quellstand eintrifft. Das ältere Ergebnis darf nicht allein deshalb zum aktuellen Stand werden, weil es zuletzt fertig wird.
Legen Sie fest, wo Wiederverwendung akzeptierte Zielübersetzungen erhält und wo eine neue Generierung vorgesehen ist. Dass API, CLI und App dasselbe Format unterstützen, bedeutet nicht, dass sie identische Optionen bieten. Berücksichtigen Sie im Entwurf den exakten Ausgangsstand des Aufrufers und sein Verhalten beim Erzwingen einer Ausführung.
Ungeklärte Fälle einplanen #
Legen Sie fest, was bei einer abgelehnten Eingabe, einer fehlgeschlagenen Zielübersetzung, einem unterbrochenen Abruf, einer ausstehenden Prüfung, einem lokalen Konflikt oder einer unklaren Antwort geschieht. Der nächste Schritt sollte bekannte Arbeit gemäß der jeweiligen Schnittstellenvereinbarung wiederherstellen – nicht alles neu starten, nur weil eine Empfangsbestätigung verloren gegangen ist.
Einige fertige Zielübersetzungen können bereits für die Bereitstellung vorgemerkt sein, während eine andere noch ungeklärt ist. Entscheiden Sie, ob für die Veröffentlichung alle benötigt werden oder ob bewusst eine Ersatzlösung zum Einsatz kommen kann. Die Prüfungsrichtlinie legt fest, welche Folgen fehlende Entscheidungen und Zeitüberschreitungen haben. Belassen Sie die Ausführungssteuerung bei dem Werkzeug, das für die Arbeit zuständig ist, statt eine universelle Wiederholungsaktion zu erfinden.
Qualitätsnachweise nachvollziehbar machen #
Definieren Sie die Fragen, die für die Veröffentlichung relevant sind – auch für Übersetzungen, die außerhalb von Lingo.dev erstellt wurden. Eine Messung kann Arbeit mit Prüfungsbedarf sichtbar machen, ohne selbst zum System zu werden, das akzeptierte Inhalte verwaltet oder über die Veröffentlichung entscheidet.
Die Messplanung erläutert Kriterien, Nachweise, Antwortzustände und die in Berichten betrachteten Gruppen. Legen Sie als Teil des Workflows fest, wer diese Nachweise interpretiert und Unklarheiten über die Bedeutung der Quellinhalte auflöst.
Vor der Erweiterung einen vollständigen Durchlauf nachweisen #
Führen Sie eine Quelländerung durch den gesamten Ablauf: Einreichung, Abruf, Validierung, Prüfung, Bereitstellung und Nutzung. Ändern Sie in einem sicheren Test die Quelle während der Verarbeitung und simulieren Sie eine fehlgeschlagene Zielübersetzung. Stellen Sie sicher, dass die aktuelle Revision weiterhin erkennbar ist und die Wiederherstellung akzeptierte Ausgaben erhält.
Halten Sie mit einem Workflow-Testlauf fest, was tatsächlich ausgeführt wurde und was noch ungetestet ist. Der Entwurf ist bereit für die Erweiterung, wenn eine andere zuständige Person sowohl erklären kann, wie eine Übersetzung nutzbar wird, als auch, wie sich der vorherige nutzbare Zustand wiederherstellen lässt.