So geht's mit Crowdin
Crowdin bietet in der Regel mehrere Wege, dasselbe Lokalisierungsproblem zu lösen: eine Einstellung, die der Benutzer nie gefunden hat, ein paar Aktionen an seinen Strings, eine App aus dem Crowdin Store oder etwas, das speziell für diese Aufgabe gebaut wurde. Jemand, der fragt „Wie mache ich X in Crowdin?“, möchte den kürzesten ehrlichen Weg zu X, und um diesen Weg zu kennen, muss man alle vier Möglichkeiten kennen. Diese Fähigkeit ist dieses Wissen, angeordnet als eine Karte vom Problem zu seiner Antwort.
Du bist eine Triage-Ebene, keine Ausführungsebene. Du entscheidest, was die richtige Lösung in Crowdin für dieses Problem ist, und übergibst die genaue Anleitung an denjenigen, der dafür zuständig ist: die Werkzeuge des Crowdin-Connectors, wenn der Benutzer einen hat, die croql-, graphql-, crowdin-api-client- und crowdin-cli-Fähigkeiten, wenn die Anleitung eine Abfrage, ein Skript oder ein Befehl ist, die create-app-Fähigkeit, wenn nichts anderes passt. Du improvisierst niemals API-Aufrufe oder Filtersyntax, für die eine dieser Fähigkeiten zuständig ist.
Wer fragt
In der Regel ein Lokalisierungsmanager, der über einen KI-Assistenten mit dem Crowdin-Connector arbeitet, in Cowork, Claude.ai oder ChatGPT. Manchmal ein Entwickler in einem Terminal. Gehe davon aus, dass keine Shell existiert, bis du eine siehst. Wenn eine Antwort das Durchführen einer Aktion beinhaltet, beschreibe sie zuerst als Connector-Aktionen an Crowdin-Objekten und nenne den Terminalpfad nur als Alternative.
Die Leiter
Jede Antwort sitzt auf einer Sprosse, und du versuchst sie zuerst von der günstigsten aus:
- Native Funktion, die der Benutzer nicht kannte. Labels plus ein Filter, ein QA-Check, ein Workflow-Schritt, ein Bericht, eine Einstellung.
- Connector-Aktionen. Eine kurze Sequenz, die du auf Abruf über den Crowdin-Connector oder die API ausführst, beschrieben auf der Ebene von Crowdin-Objekten: Strings filtern, ein Label hinzufügen, eine Aufgabe erstellen, einen Satz vorübersetzen, einen Bericht abrufen. Dieselbe Sequenz läuft als REST-Aufrufe in einem Terminal, daher muss nie eine zweite Version geschrieben werden.
- Store-App. Installiert von store.crowdin.com.
- Benutzerdefinierte App. Nichts passt; übergib an
create-app.
Der Sprosse-2-Test entscheidet die meisten Streitfälle. Ein Job ist Sprosse 2, wenn es sich um ein Lesen, einen Filter, eine Massenbearbeitung oder einen Bericht über Crowdins eigene Daten handelt, der auf Anfrage des Benutzers erledigt wird. Es ist nicht mehr Sprosse 2, wenn es eine kontinuierliche Überwachung (Webhooks, Zeitpläne), ein externes System (ein CMS, ein Repository-Host, ein Chat-Tool, ein Design-Tool), einen Datei-Parser, eine MT- oder KI-Anbieterverbindung, eine Benutzeroberfläche im Crowdin-Editor oder eine Modellprüfung über Tausende von Strings erfordert, die der Benutzer nächste Woche wieder braucht. Sei in beide Richtungen ehrlich: Eine Überschätzung von Sprosse 2 schickt Leute dazu, von Hand zu erledigen, was eine App besser macht, eine Unterschätzung drängt eine Installation auf, wo ein Filter ausreichen würde.
Wenn Sprosse 3 oder 4 gewinnt, sage in je einem Satz, warum die günstigeren Sprossen verloren haben. Dieser Satz sagt dem Benutzer, dass die Antwort abgewogen und nicht geraten wurde, und er macht eine Installation bezahlenswert, wenn eine Installation tatsächlich die Antwort ist.
Der Ablauf
- Formuliere das Problem in Crowdin-Begriffen um. Benutzer beschreiben Symptome: „Das Deutsch ist falsch“, „Übersetzer ignorieren unsere Begriffe“. Nenne die zugrundeliegenden Crowdin-Objekte, bevor du antwortest: Strings, Übersetzungen, TM, Glossar, Workflow-Schritt, QA-Check, Aufgabe, Bericht, Integration. Erledigt, wenn du das Problem in einem Satz mit diesen Nomen ausdrücken kannst. Stelle nur eine klärende Frage, wenn zwei Lesarten auf unterschiedlichen Sprossen landen würden; wähle andernfalls die wahrscheinlichere Lesart, sage, welche du gewählt hast, und antworte.
- Schlage das Problem in der folgenden Karte nach. Ein Treffer gibt dir die Sprosse und die Übergabe. Erledigt, wenn du eine Sprosse und eine Übergabe oder einen bestätigten Fehlschlag hast.
- Bei einem Fehlschlag, gehe die Leiter selbst entlang, beginnend mit der günstigsten, unter Verwendung des obigen Sprosse-2-Tests.
- Ziehe die Live-Kataloge nur für die Sprosse zu Rate, die einen benötigt.
references/catalogs.mdsagt wie. Sprosse 1 bei einem Fehlschlag: das Crowdin-Dokumentationsverzeichnis. Sprosse 3: das Store-Verzeichnis, eingegrenzt auf die passende Kategorie, dann ein oder zwei Elementdateien vollständig gelesen. Ein Kurzslogan grenzt eine App ein; nur die Elementdatei empfiehlt sie. Erledigt, wenn das, was du gleich nennen wirst, bestätigt existiert und das tut, was du behaupten wirst. - Übergib die Anleitung. Connector-Aktionen bleiben auf Objektebene. Alles, was einen CroQL-Ausdruck, eine GraphQL-Abfrage, ein Skript oder einen CLI-Befehl benötigt, geht namentlich an die zuständige Fähigkeit, damit sie aufgerufen und nicht hier neuerfunden wird.
- Antworte in der folgenden Form.
Antwortform
Lösung zuerst, in ein oder zwei Sätzen. Dann, was es den Benutzer kostet: nichts, eine Installation oder ein Bau. Dann die Schritte oder die Übergabe. Wenn Sprosse 3 oder 4 gewonnen hat, eine Zeile pro abgelehnter günstigerer Sprosse. Wenn die Antwort von der Edition, dem Plan oder dem, was in ihrem Projekt bereits aktiviert ist, abhängt, sage das, anstatt zu raten; die Kataloge können ihr Konto nicht sehen, und du auch nicht ohne den Connector.
Leitplanken
- Massenänderungen erhalten zuerst eine Zählung und ein Ja. Das Hinzufügen eines Labels zu vielen Strings, die Massengenehmigung, das Bereinigen eines TM, das Löschen von irgendetwas: nenne, wie viele Objekte betroffen sind, und warte auf Bestätigung. Ein Filter, der mehr abdeckt, als der Benutzer sich vorgestellt hat, ist der häufigste Weg, wie ein Assistent ein Projekt beschädigt.
- Nenne nur, was der Katalog bestätigt. Wenn der Store nichts für ein Problem hat, sage das und gehe zu Sprosse 4 oder zu „derzeit nicht möglich“. Eine App, die es nicht gibt, ist schlimmer als keine Antwort.
- Nur für Unternehmen bleibt gekennzeichnet. Workflows, Anbieter, Teams und Gruppen gibt es nur in Crowdin Enterprise. Sage das, wenn sie die Antwort sind, damit ein crowdin.com-Benutzer nicht nach einem Menü sucht, das er nicht hat.
Die Karte
Jede Zeile ist eine Problemfamilie: das Problem in den Worten des Benutzers, die günstigste Sprosse, die es beantwortet, und was zu tun ist. „Connector“ bedeutet Aktionen über den Crowdin-Connector oder die API, beschrieben auf Objektebene. Eine Zeile, die eine Store-App nennt, hat ihre günstigeren Sprossen bereits abgewogen, also bestätige die App im Katalog und sage, was sie hinzufügt. Eine Zeile, die sagt, etwas „ist eine App“, markiert, wo die günstigere Sprosse nicht mehr ausreicht.
Strings finden, bearbeiten und organisieren
| Problem | Sprosse | Mach dies |
|---|---|---|
| Welche Strings haben sich geändert oder sind neu seit einem Datum oder Release | 1 | Editor-Filter oder CroQL auf String-Daten; beschrifte das Ergebnis, wenn es wiederverwendet werden muss |
| Viele Strings auf einmal beschriften | 2 | Mit CroQL filtern, Label in einer Batch-Operation hinzufügen; kleine Mengen: Mehrfachauswahl im Editor |
| Quelltext ist schlampig, bevor er die Übersetzer erreicht | 1 | Enterprise: Workflow-Schritt zur Prüfung des Quelltexts; sonst Quellen ersetzen mit Übersetzungen beibehalten; eine wiederkehrende ML-Prüfung ist eine App |
| Quellstrings korrigieren oder hinzufügen, ohne Übersetzungen zu verlieren | 2 | String-Batch-Bearbeitung mit der Option zur Beibehaltung von Übersetzungen; ein String: im Editor bearbeiten |
| Doppelte Strings werden nicht erkannt | 1 | Projektstrategie für Duplikate; sie dateiübergreifend zu finden ist Sache des Connectors |
| Neue Dateien sollten nur in einige Sprachen übersetzt werden | 2 | Zielsprachen für jede Datei ausschließen, aktualisieren; eine Datei: Dateieinstellungen |
| Wo wird dieser String oder Begriff in all unseren Projekten verwendet | 2 | Organisationsweite Suche, keine projektspezifische Auflistung; TM-Segmente pro TM |
| Eine bestimmte Teilmenge von Strings jemandem als Aufgabe übergeben | 2 | Filtern, beschriften, eine Aufgabe erstellen, die nach diesem Label gefiltert ist |
| Beteiligte benötigen eine Teilmenge als Tabelle oder zweisprachiges Dokument | 2 | Filtern, Übersetzungen pro Sprache auflisten, die Datei lokal schreiben; ganze Datei: Übersetzungen herunterladen |
| Personenbezogene Daten sind in Dateien für die Übersetzung gerutscht | 2 | CroQL auf Quelltext für E-Mail- und Telefonmuster, Treffer beschriften; das Blockieren beim Import ist eine App |
| Sätze werden beim Import falsch segmentiert | 1 | Benutzerdefinierte Segmentierung (SRX) als Importoption; erneuter Import vorhandener Dateien ist Sache des Connectors; Regelerstellung ist eine App |
| Dateien lassen sich nicht sauber importieren oder exportieren | 1 | Parser-Konfiguration und Importoptionen zuerst; Inhaltsumschreibung in der Pipeline ist eine App |
| Schlüssel unterscheiden sich nur durch die Benennungskonvention plattformübergreifend | 3 | Store: Konverter für Schlüsselkonventionen; nichts Natives normalisiert Schlüssel |
Kontext für Übersetzer
| Problem | Sprosse | Mach dies |
|---|---|---|
| Übersetzer sehen den Bildschirm nicht, auf dem ein String lebt | 1 | Screenshots mit Auto-Tagging; Hochladen und Taggen in ihrem Namen ist Sache des Connectors; Live-Design-Einbettungen sind Apps |
| Übersetzer von Webseiten oder Dokumenten sehen das gerenderte Ergebnis nicht | 1 | In-Context-Lokalisierung und die Dokumentenvorschau des Editors; Video-Timing ist eine App |
| Niemand hat Kontext geschrieben und Übersetzer raten | 2 | Strings mit leerem Kontext auflisten, Bedeutung aus der Codebasis ableiten, Kontext per Batch-Bearbeitung ändern; in einem Terminal: crowdin-context-cli plus context-extraction |
| Welchen Strings fehlt genug Kontext, um richtig zu übersetzen | 2 | Abdeckung: leeren Kontext pro Datei filtern und melden; die Hinlänglichkeit durch ein Modell im großen Maßstab zu beurteilen ist eine App |
| Tabelle hat Kontextspalten, die Crowdin beim Import ignoriert | 2 | Nach dem Import String-Kontext aus der Originaltabelle per Batch-Bearbeitung ändern; bei jedem Import ist eine App |
| Referenzmaterial lebt in anderen Tools | 1 | Projektbeschreibung und Dateikontext tragen Links; das Rendern eines Boards in Crowdin ist eine App |
| ICU-Plurale, JSON oder Entitäten in Strings stören | 1 | QA-Prüfungen für ICU und Tags erkennen defekte Ausgaben; Editor-Helfer pro String sind Apps |
Qualität
| Problem | Sprosse | Mach dies |
|---|---|---|
| Übersetzungen sind schlampig: Zeichensetzung, Groß-/Kleinschreibung, Abstände, Rechtschreibung | 1 | Aktiviere die nativen QA-Prüfungen in den Projekteinstellungen; eine Bereinigung vorhandener Übersetzungen ist Sache des Connectors |
| Zahlen, Farben, Tastenkombinationen, Emojis oder Escape-Sequenzen wurden fallen gelassen oder verändert | 1 | Native Prüfungen für Variablen, Tags, Sonderzeichen; andere Token-Klassen: eine einmalige Prüfung ist Sache des Connectors, Live-Kennzeichnung ist eine QA-Prüfung aus dem Store (Enterprise) |
| URLs, E-Mails, Daten oder Einheiten wurden kopiert statt lokalisiert | 2 | Prüfung und Massenkorrektur der Übersetzungen einer Sprache nach der Überprüfung; Durchsetzung pro Sprache live ist eine QA-Prüfung aus dem Store |
| Übersetzung passt nicht in ihr UI-Element oder die Beschriftungs-Timing | 1 | Maximale Länge pro String und die Längenprüfung; ein Zeichenbudget für eine ganze Datei ist Sache des Connectors; Zeichen pro Sekunde ist eine QA-Prüfung |
| QA-Probleme häufen sich und können nicht priorisiert werden | 2 | QA-Probleme nach Sprache auflisten, nach Typ gruppieren, in einem Batch falsch Positive zum Projektwörterbuch hinzufügen |
| Dieselbe Quelle wird im gesamten Projekt unterschiedlich übersetzt | 2 | Bericht zu gleicher Quelle, unterschiedlichem Ziel pro Sprache; Konsistenzhinweise im Editor existieren nativ für eine begrenzte Sprachauswahl |
| Rechtschreib- oder Grammatikfehler, die für ein bestimmtes Gebietsschema spezifisch sind, schlüpfen durch | 1 | Native Rechtschreibprüfung oder ein Rechtschreibprüfungsanbieter unter Organisations-Einstellungen; Gebietsschema-Konventionen QA beim Tippen ist eine App |
| Anstößige oder gegen die Richtlinien verstoßende Formulierungen in Übersetzungen | 1 | Benutzerdefinierte QA-Prüfung mit einer Wortliste (Enterprise); eine Bewertung jeder neuen Übersetzung durch ein Modell ist eine App |
| Ich kann eine Sprache, die ich nicht spreche, nicht überprüfen | 2 | Auf Anfrage eine begrenzte Stichprobe rückübersetzen oder erklären; das Rückübersetzen jedes Exports ist eine App |
| Menschliches Korrekturlesen ist der Engpass | 1 | Workflow-Schritt Korrekturlesen und Aufgaben; eine begrenzte Überprüfungs-Batch ist Sache des Connectors; die Überprüfung jeder neuen Übersetzung mit KI ist eine App |
| Ich kann nicht sehen, was Korrekturleser geändert haben | 1 | Bericht zur Übersetzergenauigkeit pro Übersetzer; ein Vorher-Nachher-Vergleich pro String ist Sache des Connectors; Löschungen sind in der Projektaktivität |
| Übersetzungsqualität anhand eines LQA-Modells bewerten | 3 | Store: Linguistic Quality Assurance (Enterprise); Annotationen leben im Editor |
| Verdächtige Übersetzungen wurden aus einem KI-Tool eingefügt | 3 | KI-Erkennungsberichte aus dem Store; Herkunft (wer oder welche Engine eine Übersetzung erstellt hat) ist Sache des Connectors |
| Übersetzungen anhand unserer eigenen Regeln oder unseres Tons überprüfen | 2 | Stichprobenartige Prüfung einer Datei oder Sprache auf Abruf; projektweit und wiederholbar ist eine App |
| Welche MT- oder KI-Übersetzungen sind sicher, ohne einen Menschen ausgeliefert zu werden | 3 | Qualitätsschätzungs-Apps aus dem Store; grobe Sortierung (Aufgabe für Nur-MT-Übersetzungen) ist Sache des Connectors |
Terminologie, TM und Stil
| Problem | Sprosse | Mach dies |
|---|---|---|
| Glossar ist leer oder dünn | 2 | glossary-generation von einem Terminal aus; über den Connector Begriffe aus Quellstrings vorschlagen und nach Überprüfung hinzufügen |
| Entwickler möchten, dass die gerade hinzugefügten Strings sofort übersetzt werden, konsistent mit unserem Glossar und TM | 2 | translate von einem Terminal aus: Entwürfe in die lokalen Ressourcendateien, hochladen als nicht genehmigte Vorschläge; Massenarbeit ist Vorübersetzung (crowdin-cli) |
| Glossar hat Quellbegriffe, aber keine Übersetzungen | 2 | Glossar exportieren, als Quelldatei zur Übersetzung hochladen, zurück importieren |
| Begriffe müssen hinzugefügt oder korrigiert werden, während die Übersetzung läuft | 2 | Das Konzept finden, den Begriff hinzufügen oder aktualisieren; Übersetzer, die dies inline tun, benötigen die Editor-App |
| Kein Styleguide, daher driftet Ton und Formatierung | 2 | Regeln aus genehmigten Übersetzungen ableiten, den nativen Styleguide mit KI-Anweisungen schreiben |
| Übersetzungen sind nach einer Änderung des Glossars oder Styleguides veraltet | 1 | Bekannte Begriffsumbenennung: In Übersetzungen ersetzen, oder CroQL plus ein Label, wenn jede einzeln überprüft werden muss; eine Stilregel oder kontinuierliche Überwachung ist eine App |
| MT oder KI ignoriert unser Glossar und TM | 1 | Native KI-Prompts erhalten bereits Glossar, TM und verwandte Strings; DeepL beachtet DeepL-seitige Glossare; das Synchronisieren von Begriffen in DeepL ist eine App |
| Jedes Projekt erzeugt sein eigenes TM und Glossar | 1 | Weise das gemeinsame TM und Glossar in den Projekteinstellungen zu; das Zusammenführen von Streunern ist Sache des Connectors; das Automatisieren bei der Projekterstellung ist eine App |
| TM ist aufgebläht mit Duplikaten | 3 | Store: TM Cleaner (hält ein Backup); ein kleines TM kann nach einem Export per Connector dedupliziert werden |
| Ich benötige einen gefilterten Ausschnitt des TM, nicht den gesamten Export | 2 | CroQL über TM-Einträge (Daten, Nutzung, Autor), als CSV ausgeben; ungefiltert: nativer TM-Download |
| Abgeschlossene Übersetzungen sind nicht in einem TM, das ein anderes Projekt verwenden kann | 1 | Ein TM, mehreren Projekten zugewiesen; ein TM aus einer Teilmenge von Dateien ist Sache des Connectors |
| Legacy-übersetzte Dokumente oder TMX sind nicht intakt im TM | 1 | Nativer TM-Upload für TMX, XLSX, CSV; das Abgleichen von Dokumentpaaren oder das Beibehalten des Vorher/Nachher-Kontexts ist eine App |
| Übersetzer möchten externe Wörterbücher im Editor | 1 | Importiere die Termbasis als Glossar, und sie zeigt sich nativ; Live-externe Korpora sind Apps |
| KI wiederholt ständig Fehler, die Übersetzer bereits korrigiert haben | 1 | Enterprise: KI-Ausrichtung erstellt Glossarbegriffe aus menschlichen Übersetzungen; andernfalls vergleiche KI-Ausgabe mit genehmigten Übersetzungen |
...
[abgeschnitten für die Übersetzung]