Starten Sie sprachübergreifende Schnittstellendokumente mit Felddefinitionen: Namen, Typen, Einheiten, Bereiche und Bedeutungen von Null- und fehlenden Werten. Unterscheiden Sie Protokollkennungen von Lesererklärungen. Sofern die Schnittstellendefinition dies nicht zulässt, ändern Sie beim Übersetzen natürlicher Sprache keine Feldbezeichner, Aufzählungswerte oder Fehlercodes.

Bewahren Sie Versionen und Zuordnungen für Änderungen auf

Wenn sich Parameterbedeutung, Standardeinstellungen, Fehlerbehandlung oder Struktur ändern, notieren Sie die Schnittstellenversion und die Migrationsregeln. Verknüpfen Sie lokalisierte Dokumente mit derselben Version und markieren Sie Abschnitte, die noch nicht aktualisiert sind. Speichern Sie frühere Definitionen, Überarbeitungen und Beispiele, um eine Vermischung alter und neuer Anweisungen zu verhindern.

Vergleichen Sie die Beispiele mit der tatsächlichen Schnittstelle

Analysieren Sie Anfragen und Antworten in der vereinbarten Umgebung. Überprüfen Sie Felder, Werte und Fehlerzweige. Verwenden Sie stabile Bezeichner, um lokalisierte Fehlererklärungen zu verknüpfen. Überprüfen Sie fehlende Parameter, ungültige Werte und nicht unterstützte Versionen. Melden Sie übersetzte Beispiele erst dann als verifiziert, wenn Sie die entsprechenden Prüfungen durchgeführt haben.

Überprüfen Sie gemeinsam Sprache und Textrichtung

In den Internationalisierungsleitlinien des W3C werden Sprach- und Textrichtungsinformationen für Nachrichten in natürlicher Sprache erörtert. Unterscheiden Sie lesbare Erklärungen von Programmkennungen. Überprüfen Sie bidirektionalen Text, Codeschnipsel und Zahlendarstellung. Behalten Sie die Rendering- und Parsing-Ergebnisse bei. Ein lesbares Layout ersetzt nicht die Überprüfung der Protokollfunktion.

Sehen W3C-Leitfaden zur Internationalisierung.