better-i18n Translation Version Control: Vollständige Historie & Rollback

Ihr Anwendungscode lebt in Git. Jede Änderung wird verfolgt. Jede Zeile hat einen bekannten Autor. Jede Version kann in Sekunden wiederhergestellt werden. Wenn ein fehlerhafter Commit in die Produktion gelangt, führen Sie einen Rollback durch. Wenn Sie verstehen möchten, warum eine Funktion auf eine bestimmte Weise geschrieben wurde, lesen Sie die Commit-Historie.

Ihre Übersetzungen verdienen dieselbe Behandlung. Doch in den meisten Lokalisierungsplattformen ist die Historie ein Nachgedanke — bestenfalls ein einfaches Änderungsprotokoll, mit eingeschränkter Suche, ohne Diff-Ansicht und ohne Rollback. Wenn in der Produktion etwas mit einer Übersetzung schiefgeht, verbringen Teams Stunden damit, herauszufinden, was sich geändert hat, wann und warum — und dann noch mehr Stunden damit, eine frühere Version manuell wiederherzustellen.

better-i18n behandelt Translation Version Control als erstklassiges Feature. Jede Änderung an jedem String wird mit einem vollständigen Diff, einem Zeitstempel und der Identität des Beitragenden aufgezeichnet. Rollback zu einer beliebigen früheren Version ist ein einziger Klick. Die vollständige Historie ist abfragbar, durchsuchbar und über die API verfügbar.

Wie es funktioniert

Automatische Versionierung bei jedem Speichern

Jedes Mal, wenn ein Übersetzungs-String in better-i18n geändert wird — über den Web-Editor, über das CLI-Tool, über die MCP-Integration oder über die API — wird automatisch eine neue Version erstellt. Versionen werden für jede Sprache unabhängig erstellt, sodass das Ändern der deutschen Übersetzung eines Strings eine neue Version des deutschen Strings erstellt, ohne die französische Version zu beeinflussen.

Versionen werden unabhängig davon erstellt, wer die Änderung vorgenommen hat. Menschliche Übersetzer, KI-Assistenten, die über die MCP-Verbindung arbeiten, automatisierte Bulk-Update-Skripte über die CLI — alle erzeugen versionierte Historie. Es gibt keine Möglichkeit, eine Übersetzung zu ändern, ohne einen Datensatz zu hinterlassen.

Was jede Version aufzeichnet

Jeder Versionsdatensatz enthält:

Zeitstempel: Der genaue Zeitpunkt, zu dem die Version erstellt wurde, in UTC.
Autor: Die Identität des Benutzers oder Dienstes, der die Änderung vorgenommen hat. Für menschliche Benutzer sind dies Name und Profil. Bei API- oder CLI-Operationen ist es der API-Token-Bezeichner.
Vor- und Nach-Inhalt: Der vollständige Text der Übersetzung vor und nach der Änderung, der eine vollständige Diff-Ansicht ermöglicht.
Statusübergang: Ob der String von einem Status in einen anderen gewechselt hat (z. B. von „in Bearbeitung" zu „zur Überprüfung eingereicht" oder von „genehmigt" zu „muss überarbeitet werden").
Änderungshinweis: Eine optionale Nachricht des Autors, ähnlich einer Commit-Nachricht. Der Kollaborations-Workflow ermutigt Autoren, Änderungshinweise hinzuzufügen, wenn sie Korrekturen auf Basis von Reviewer-Feedback vornehmen.
QA-Prüfergebnisse: Der QA-Status des Strings zum Zeitpunkt der Versionserstellung. Dieser wird aus der Qualitätssicherungs-Engine abgerufen und mit der Version für spätere Referenz gespeichert.

Historie anzeigen

Das Historiepanel für jeden String zeigt alle seine Versionen in umgekehrt chronologischer Reihenfolge. Jeder Eintrag zeigt den Autor, den Zeitstempel, den Status dieser Version und einen komprimierten Diff der Inhaltsänderung (hinzugefügte Wörter grün hervorgehoben, entfernte Wörter rot hervorgehoben).

Durch Klicken auf eine beliebige Version wird der vollständige Inhalt zu diesem Zeitpunkt angezeigt — nicht nur der Diff, sondern der vollständige String, wie er beim Erstellen dieser Version existierte.

Die Historie kann auch auf Projektebene durchsucht werden. Sie können eine Zeitleiste aller Änderungen über alle Strings in einem Projekt anzeigen, gefiltert nach Sprache, Autor, Zeitraum oder Statusänderung. Dies ist nützlich für Audits, für Post-Incident-Reviews und um das Gesamttempo und -muster der Übersetzungsaktivität zu verstehen.

Rollback

Das Zurücksetzen eines Strings auf eine frühere Version ist eine einzige Aktion. Im Historiepanel klicken Sie auf „Diese Version wiederherstellen" bei einem beliebigen Eintrag. Der aktuelle Inhalt wird durch den Inhalt der ausgewählten Version ersetzt. Eine neue Version wird erstellt, die den Rollback dokumentiert, einschließlich welche Version wiederhergestellt wurde und wer den Rollback durchgeführt hat.

Rollback ist für Editoren und Admins verfügbar. Übersetzer und Reviewer können die Historie anzeigen, aber keinen Rollback durchführen, um die versehentliche oder unbefugte Wiederherstellung alter Inhalte zu verhindern.

Sie können auch eine gesamte Sprache auf ihren Zustand zu einem bestimmten Zeitstempel zurücksetzen. Dies ist nützlich, wenn eine Massenoperation — eine Terminologieaktualisierung, eine KI-gestützte Massenübersetzung — unerwartete Ergebnisse über viele Strings hinweg erzeugt. Anstatt jeden String einzeln zurückzusetzen, stellen Sie die gesamte Sprache auf ihren Vor-Operationszustand wieder her und wiederholen die Operation mit korrigierten Parametern.

Versionen vergleichen

Die Diff-Ansicht in better-i18n ist auf Wortebene, nicht auf Zeilenebene. Übersetzungs-Strings sind typischerweise einzelne Sätze oder kurze Absätze. Ein zeilenstufiger Diff würde oft den gesamten String als geändert anzeigen. Ein wortgenauer Diff zeigt präzise, welche Wörter hinzugefügt, entfernt oder umgestellt wurden, was es viel einfacher macht zu verstehen, was tatsächlich geändert wurde.

Sie können beliebige zwei Versionen eines Strings vergleichen — nicht nur benachbarte Versionen. Wählen Sie zwei Punkte in der Historie aus und sehen Sie das Delta zwischen ihnen, unabhängig davon, wie viele Zwischenversionen existieren.

Tagging und Release-Snapshots

Wenn Sie eine neue Version Ihrer Anwendung deployen, können Sie den aktuellen Zustand Ihrer Übersetzungen mit einem Release-Label versehen:

bi18n tag --name v2.5.0 --message "Release 2.5.0 translations"

Dies erstellt einen Snapshot jeder Übersetzung in ihrem aktuell genehmigten Zustand. Sie können später den Zustand eines beliebigen Strings bei jedem Release-Tag abfragen, Übersetzungen zwischen Releases vergleichen und einzelne Strings bei Bedarf auf ihren Zustand bei einem früheren Release zurücksetzen.

Release-Tags sind im Analytics-Dashboard sichtbar, das Coverage- und Qualitätsmetriken für jeden getaggten Release anzeigt.

Audit-Export

Für regulierte Branchen oder Compliance-Anforderungen kann die vollständige Änderungshistorie für ein Projekt oder einen bestimmten Zeitraum als strukturierte CSV- oder JSON-Datei exportiert werden. Der Export enthält jeden Versionsdatensatz für jeden String in jeder Sprache, mit vollständigem Vor-und-Nach-Inhalt und Zuordnungsdaten.

Dieser Export eignet sich zum Anhängen an Compliance-Berichte, für externe Audit-Reviews oder für Archivierungszwecke.

Hauptvorteile

Vollständige Verantwortlichkeit

In einer Team-Übersetzungsumgebung geht gelegentlich etwas schief. Ein Auftragnehmer überschreibt einen sorgfältig genehmigten String. Ein automatisiertes Skript wendet eine Terminologieänderung an, die sich als falsch herausstellt. Ein Reviewer genehmigt einen String mit einem defekten Platzhalter, der durchgerutscht ist.

Wenn jede Änderung mit Zuordnung und Zeitstempeln aufgezeichnet wird, können Sie immer die Frage „Was ist passiert?" beantworten. Sie wissen genau, wer die Änderung vorgenommen hat, wann und wie der Inhalt vor der Änderung war. Dies ist Verantwortlichkeit in demselben Sinne, wie Git Verantwortlichkeit für Code-Änderungen bietet.

Schnelle Incident-Wiederherstellung

Wenn ein Übersetzungsproblem die Produktion erreicht — ein defekter Platzhalter, der einen JavaScript-Fehler verursacht, ein falsch übersetzter rechtlicher Haftungsausschluss, ein völlig falscher String — müssen Sie es schnell beheben. Ohne Version Control bedeutet die Behebung einer schlechten Übersetzung, die alte Version zu finden (die möglicherweise nirgendwo existiert), sie wiederherzustellen, erneut zu veröffentlichen und neu zu deployen.

Mit better-i18n Version Control ist die Wiederherstellung: String finden, Historie öffnen, auf „Wiederherstellen" klicken, veröffentlichen und ein Deploy auslösen. Die gesamte Operation dauert unter zwei Minuten. Das CLI-Tool kann die wiederhergestellte Übersetzung sofort für ein schnelles Deployment abrufen.

Sichere Massenoperationen

Massenoperationen — Terminologieaktualisierungen, KI-Massenübersetzungen, Rebranding-String-Ersetzungen — sind mächtig, aber riskant. Wenn eine Massenoperation falsche Ergebnisse produziert, benötigen Sie eine Möglichkeit, sie rückgängig zu machen. better-i18n's Version Control macht Massenoperationen sicher, indem sichergestellt wird, dass jeder von der Operation berührte String seinen vorherigen Zustand aufgezeichnet hat und wiederherstellbar ist.

Bevor Sie eine große Massenoperation ausführen, können Sie den aktuellen Zustand als Sicherheitscheckpoint taggen. Wenn die Operation schiefgeht, stellen Sie zum Checkpoint wieder her.

Integration mit Code Version Control

Translation Version Control in better-i18n ist darauf ausgelegt, die Git-basierte Version Control Ihres Codebases zu ergänzen, nicht zu ersetzen. Wenn Sie einen Release in better-i18n mit derselben Versionsnummer taggen, die Sie in Git verwenden, erstellen Sie eine permanente Verbindung zwischen dem Zustand Ihres Codes und dem Zustand Ihrer Übersetzungen bei diesem Release. Das Post-Release-Debugging wird viel sauberer, wenn Sie beides korrelieren können.

Das CLI-Tool unterstützt das automatische Erstellen von Tags als Teil Ihrer Deployment-Pipeline, sodass die Verbindung zwischen Code- und Übersetzungsversionen ohne manuellen Aufwand aufrechterhalten wird.

Compliance und Audit-Bereitschaft

Für Produkte in regulierten Branchen ist der Nachweis der Historie von Inhaltsänderungen oft eine Compliance-Anforderung. Legal Tech, Fintech, Gesundheitswesen und Regierungssoftwareprodukte müssen häufig nachweisen, dass ihr benutzerorientierter Text — einschließlich übersetzter Versionen — von bestimmten Rollen zu bestimmten Zeiten überprüft und genehmigt wurde.

better-i18n's Versionshistorie liefert diesen Nachweis direkt aus dem System. Der Audit-Export produziert einen maschinenlesbaren Datensatz, der Prüfern vorgelegt oder in Compliance-Berichte integriert werden kann.

Anwendungsfälle

Post-Release Incident Response: Ein deutscher Benutzer meldet, dass eine Zahlungsbestätigungsnachricht einen rohen Variablennamen anstelle des tatsächlichen Betrags anzeigt. Sie durchsuchen die Versionshistorie der deutschen Übersetzung des Zahlungsbestätigungs-Strings, finden heraus, dass er gestern von einem automatisierten Skript geändert wurde, das versehentlich einen Platzhalter entfernt hat, setzen ihn auf die letzte bekannte gute Version zurück und lösen einen Redeploy aus.

Rebrand-Review: Ihr Unternehmen führt ein Rebranding durch und ändert einen wichtigen Produktnamen in allen Übersetzungen. Nach dem Bulk-Update bemerkt ein Stakeholder, dass der neue Name inkonsistent verwendet wird. Sie verwenden die Historienansicht, um den aktuellen Zustand mit dem Pre-Rebrand-Snapshot zu vergleichen, identifizieren, welche Strings noch aktualisiert werden müssen, und korrigieren sie.

Auftragnehmer-Audit: Der Vertrag eines externen Übersetzungsauftragnehmers läuft aus. Bevor er den Zugang verliert, exportieren Sie die vollständige Änderungshistorie für die von ihm verwalteten Sprachen. Der Export zeigt jeden String, den er erstellt oder geändert hat, mit Zeitstempeln und QA-Status und bietet einen permanenten Nachweis seines Beitrags.

Legal Hold: Ihr Rechtsteam fordert einen Nachweis aller Änderungen an Übersetzungs-Strings der Nutzungsbedingungen in den letzten 12 Monaten. Sie filtern die Historie nach String-Kategorie und Zeitraum und exportieren das Ergebnis als PDF-fertigen Bericht.

Translation Memory Wiederherstellung: Ein neuer Übersetzer überschreibt versehentlich 40 genehmigte Strings beim Bulk-Bearbeiten einer Sprache. Sie stellen die gesamte Sprache auf ihren Zustand von gestern Nachmittag wieder her und retten damit die gesamte genehmigte Arbeit, ohne etwas neu übersetzen zu müssen.

Wie better-i18n Version Control implementiert

Übersetzungsversionen in better-i18n werden als unveränderliche Datensätze gespeichert. Sobald eine Version geschrieben ist, wird sie nie geändert. Rollback modifiziert keine historischen Datensätze — es erstellt eine neue Version mit dem wiederhergestellten Inhalt. Die Historie ist ein Append-Only-Log.

Der Diff-Algorithmus ist ein wortgenauer Diff basierend auf dem Myers-Diff-Algorithmus, angepasst für natürlichsprachlichen Text statt Code. Er verarbeitet Satzumstrukturierungen, Wortumstellungen und teilweise Wortänderungen auf eine Weise, die den Diff für nicht-technische Benutzer lesbar macht.

Versionsspeicherung ist effizient. Anstatt den vollständigen Inhalt jeder Version zu speichern, speichert das System den vollständigen Inhalt für die erste Version und Diffs für nachfolgende Versionen. Der vollständige Inhalt wird beim Lesen durch Anwenden der Diff-Kette rekonstruiert. Dieser Ansatz hält die Speicheranforderungen für Projekte mit langen Historien und vielen Sprachen handhabbar.

Die Versionshistorie-API unterstützt Pagination und Filterung, wodurch es praktisch ist, die Historie für große Projekte programmatisch abzurufen, ohne den gesamten Datensatz auf einmal zu laden.

Vergleich mit Alternativen

Phrase Version History: Phrase speichert Versionshistorie, aber mit eingeschränkten Rollback-Fähigkeiten. Das Zurücksetzen erfordert die manuelle Wiedereingabe des vorherigen Inhalts anstatt einer Ein-Klick-Wiederherstellung. better-i18n bietet echten Ein-Klick-Rollback mit vollständigem Diff-Vergleich.

Lokalise Version Control: Lokalise enthält Änderungshistorie pro String, aber Bulk-Rollback auf Sprachebene ist nicht verfügbar. better-i18n unterstützt sowohl String-Level als auch Sprach-Level Rollback.

Git-verwaltete Übersetzungsdateien: Das Speichern von Übersetzungsdateien in Git gibt Ihnen vollständige Historie und Rollback über Git-Befehle, schließt jedoch nicht-technische Teammitglieder vom Beitragen und Überprüfen aus. Merge-Konflikte in JSON-Dateien sind fehleranfällig. better-i18n gibt Ihnen die Version Control-Vorteile von Git mit einem Workflow, der für alle zugänglich ist.

Keine Version Control: Viele Lokalisierungsplattformen und benutzerdefinierte Implementierungen haben keine sinnvolle Versionshistorie. Wenn etwas schiefgeht, ist die Wiederherstellung manuell und zeitaufwändig. Dies ist der Status quo, den better-i18n ersetzen soll.

Häufig gestellte Fragen

Wie lange wird die Versionshistorie aufbewahrt? Versionshistorie wird auf allen Plänen unbegrenzt aufbewahrt. Es gibt keine automatische Bereinigung alter Versionen.

Kann ich eine sehr alte Version wiederherstellen — Jahre alt? Ja. Jede Version in der Historie kann unabhängig vom Alter wiederhergestellt werden. Der wiederhergestellte Inhalt wird zur aktuellen Version, und ein neuer Versionsdatensatz wird erstellt, der die Wiederherstellung dokumentiert.

Beeinflusst Rollback veröffentlichte Strings? Rollback stellt den Inhalt und Status eines Strings auf seinen Zustand bei der ausgewählten Version wieder her. Wenn die ausgewählte Version den Status „genehmigt" hatte, hat der Rollback-String den Status „genehmigt" und kann veröffentlicht werden. Der Rollback veröffentlicht nichts automatisch — ein Veröffentlichungsschritt ist noch erforderlich.

Ist der Audit-Export für Compliance-Zwecke zulässig? Der Audit-Export bietet einen vollständigen, mit Zeitstempeln versehenen Nachweis aller Änderungen mit Zuordnung. Ob dies für einen bestimmten Compliance-Rahmen ausreicht, hängt von den Rahmenanforderungen ab. Wir empfehlen, sich mit Ihrem Compliance-Team zu beraten.

Kann ich die Historie eines Strings anzeigen, der inzwischen gelöscht wurde? Ja. Gelöschte Strings und ihre Historie werden in einem archivierten Zustand aufbewahrt. Sie können nach gelöschten Strings suchen und ihre vollständige Historie anzeigen. Gelöschte Strings können nicht ohne Neuerstellen des String-Schlüssels in den aktiven Status zurückversetzt werden.

Verlieren Sie nie wieder eine Übersetzung

Version Control für Übersetzungen ist kein Luxus — es ist eine Sicherheitsanforderung für jedes Team, das Lokalisierung ernst nimmt. better-i18n zeichnet jede Änderung auf, macht die Historie sichtbar und durchsuchbar und ermöglicht sofortigen Rollback, wenn etwas schiefgeht.

Starten Sie Ihren kostenlosen Test und sehen Sie die vollständige Historie Ihrer Übersetzungen ab dem ersten Tag.

better-i18n Translation Version Control: Vollständige Historie & Rollback