Pflege eine mehrsprachige Lektionsbibliothek und halte Übersetzungen auf dem Stand des Englischen

## Bearbeite nur Lektionen, Artikel und Übersetzungen, keinen App-Code Du pflegst eine reine Inhaltsablage: Lehrtexte, Artikel und deren Übersetzungen. Die Veröffentlichungsanwendung, die diese Inhalte darstellt, liegt anderswo und gehört nicht zu dieser Ablage. Deine Arbeit besteht aus Text, Struktur und beschreibenden Angaben – nicht aus Anwendungscode. Zu beachtende Grenzen des Geltungsbereichs: - Füge hier keinen Anwendungscode, keine Bauwerkzeuge und keine Laufzeitkonfiguration hinzu. Wenn eine Änderung erfordert, dass sich die Website anders verhält, sage das ausdrücklich und beschreibe die dafür nötige begleitende Änderung in der Veröffentlichungsanwendung, statt hier eine zu improvisieren. - Kleine Wartungsskripte, die über den Inhalt selbst berichten (zum Beispiel ein Bericht zum Übersetzungsstand), sind legitim und sollten vor dem Bearbeiten genutzt statt ersetzt werden. - Behandle jede Datei als etwas, dem eine menschliche Übersetzerin oder ein menschlicher Übersetzer später folgen muss. Eine Änderung, die für dich bequem ist, aber den Übersetzungsablauf zerstört, ist eine schlechte Änderung. - Wenn unklar ist, ob sich eine Anfrage auf die Ausgangssprache oder auf eine Übersetzung bezieht, frage nach, bevor du schreibst. Falsches Raten beschädigt stillschweigend die weiter unten beschriebene Verfolgung des Veraltungsgrads. ## Spiegle die Ordner in allen Sprachen und ändere zuerst das englische Original Die Bibliothek nutzt einen vorhersehbaren, gespiegelten Aufbau. Lektionsdateien liegen unter einem Lektionsverzeichnis, darunter ein Ordner, der nach dem ISO-Sprachcode benannt ist, darunter ein Kategorieordner und darin das Dokument selbst. Blogbeiträge liegen in einem einzigen Beitragsverzeichnis und tragen ein Datumspräfix, gefolgt von einer mit Bindestrichen getrennten Kurzbezeichnung, sodass die zeitliche Reihenfolge allein am Dateinamen erkennbar ist. Der Satz an Kategorien ist unter jeder Sprache fest vorgegeben und in allen Sprachen identisch. Übliche Kategorien sind Grundlagen, Mittelstufe, Fortgeschrittenes, Speicherung, Testen, Datenverarbeitung, rahmenwerkspezifisches Material und ein Sammelbereich für Verschiedenes. Erfinde keine Kategorie nur in einer einzelnen Sprache; führe sie überall ein oder nirgends. Eine Sprache – normalerweise Englisch – ist die einzige maßgebliche Quelle. Jedes andere Sprachverzeichnis enthält Übersetzungen davon. Daraus ergeben sich folgende Regeln: - Inhaltliche Änderungen werden zuerst in der Ausgangssprache vorgenommen und dann in die Übersetzungen übertragen. Führe niemals neue Angaben, Beispiele oder Abschnitte allein in einer Übersetzung ein. - Eine Übersetzung darf nur aus Gründen der Übersetzungsqualität für sich allein korrigiert werden: Fehlübersetzung, Grammatik, Typografie oder sprachraumübliche Konventionen. - Wenn dir in einer Übersetzung ein Fehler auffällt, der auch in der Quelle steckt, korrigiere die Quelle und behandle die Übersetzung als Folgeaufgabe. ## Erhöhe die Versionsnummer nach Umfang der Änderung und übernimm sie in Übersetzungen Jedes Dokument beginnt mit einem strukturierten Metadatenblock, der durch eine Trennlinie abgeschlossen wird. Der Block enthält mindestens eine Versionsangabe, einen Titel und einen kurzen Anriss, der das Dokument in ein bis zwei Sätzen zusammenfasst. Artikelartige Beiträge tragen zusätzlich einen Autorennamen, einen Verweis auf die verfassende Person, Schlagwörter und ein Veröffentlichungsdatum. Das Versionsfeld ist keine Zierde – es wird maschinell gelesen. Eine Übersetzung übernimmt genau die Version des Ausgangsdokuments, aus dem sie übersetzt wurde. Werkzeuge vergleichen dann die Version jeder Übersetzung mit der aktuellen Version der Quelle, um zu entscheiden, ob diese Übersetzung aktuell, leicht veraltet oder stark veraltet ist. Erhöhe die Version der Quelle je nach Umfang der Änderung: - Hauptversion: Das Dokument wurde weitgehend neu geschrieben. Die Übersetzung muss von Grund auf neu gemacht werden. - Nebenversion: Sätze, Absätze oder Beispiele wurden hinzugefügt oder entfernt. Die Übersetzung muss geprüft und nachgebessert werden. - Korrekturversion: Nur Rechtschreib- und Tippfehlerkorrekturen. Übersetzungen bleiben nutzbar. Erhöhe niemals eine Version, ohne die zugehörige Änderung vorzunehmen, und nimm niemals eine inhaltliche Änderung vor, ohne die Version zu erhöhen. Beide Fehler zerstören die Genauigkeit der Veraltungsberichte, und diese sind der einzige Mechanismus, der die übersetzte Bibliothek ehrlich hält. Wenn du eine Übersetzung bearbeitest, aktualisiere ihre Version erst dann, wenn du sie tatsächlich an den neueren Inhalt der Quelle angeglichen hast. ## Schreibe in der Wir-Form und zeige Beispiele vor der Erklärung Wende diese Konventionen auf alle Inhalte an, sofern ein sprachraumspezifischer Leitfaden sie nicht außer Kraft setzt. - Verwende die einbeziehende erste Person Plural. Die lesende Person arbeitet als Mitwirkende an deiner Seite und ist keine Schülerin, der etwas vorgetragen wird. Vermeide Formulierungen wie „du musst“ dort, wo ein „wir“ natürlich klingt. - Erst zeigen, dann erklären. Ein ausgearbeitetes Beispiel steht vor seiner Erläuterung; die lesende Person sieht die Sache, bevor sie darüber liest. - Halte Absätze kurz. Wenn die Angaben dicht werden, wandle sie in eine Aufzählung oder einen Beispielblock um, statt einen langen Absatz zu schreiben. - Schreibe im Aktiv. Verwende durchgängig eine schlichte, gesprochene Sprache statt gestelzter Vollformen. - Keine Emojis. Keine Gemeinplätze, keine lobenden Füllsätze, keine Sätze, die nur dazu da sind, den nächsten Satz einzuleiten. - Setze in Aufzählungen das Komma auch vor dem letzten Glied. - Überschriftenebenen: zweite Ebene für Hauptabschnitte, dritte Ebene für Unterabschnitte. Setze niemals eine Überschrift erster Ebene in den Fließtext – diese Ebene gehört dem Dokumenttitel. - Jeder Beispielblock gibt seine Sprachkennung an, damit die Darstellung ihn korrekt hervorheben kann. Streiche alles, was nichts vermittelt. Länge ist keine Tugend; ein kürzeres Dokument, das sich treu übersetzen lässt, ist mehr wert als ein längeres, das auseinanderdriftet. ## Ordne jede Lektion: Überblick, Beispiele, verwandte Themen Lehrdokumente folgen einer festen Erzählform: 1. Ein kurzer Überblick darüber, was das Dokument behandelt. 2. Beweggrund – warum das wichtig ist – in höchstens zwei bis drei Sätzen. Widerstehe dem Drang, diesen Abschnitt auszuweiten; hier sammelt sich am häufigsten Füllmaterial an. 3. Kerninhalt, getragen von konkreten Beispielen, denen jeweils eine Erläuterung folgt. 4. Verbindungen nach außen: wie dieses Thema mit benachbartem Stoff zusammenhängt, den die lesende Person schon gesehen hat oder als Nächstes sehen wird. Ordne den Stoff innerhalb des Kerninhalts vom einfachsten brauchbaren Fall hin zu den komplexeren Abwandlungen, und führe einen Begriff ein, bevor du dich darauf stützt. Wenn ein Dokument so wächst, dass es zwei klar trennbare Themen abdeckt, teile es auf, statt es ausufern zu lassen – zwei gezielte Dokumente lassen sich besser übersetzen und veralten unabhängig voneinander. Der Anriss im Metadatenblock sollte sich allein aus dem Überblick schreiben lassen. Wenn du das Dokument nicht in ein bis zwei Sätzen zusammenfassen kannst, leistet das Dokument zu viel. ## Füge neue Lektionen oder Sprachen hinzu und nenne die nötige Registrierung auf der Website Neues Ausgangsdokument: Lege die Datei unter dem Verzeichnis der Ausgangssprache in der richtigen Kategorie an, mit einem vollständigen Metadatenblock einschließlich einer Anfangsversion. Sage danach klar, ob in der Veröffentlichungsanwendung eine begleitende Änderung nötig ist, um das neue Dokument für die Anzeige einzutragen. Gehe nicht davon aus, dass es von selbst erscheint. Neue Übersetzung: Kopiere die Quelldatei unter demselben Kategoriepfad und mit demselben Dateinamen in das Verzeichnis der Zielsprache, übersetze den Fließtext und übersetze die für Menschen lesbaren Werte im Metadatenblock wie Titel und Anriss. Lass die strukturellen Feldnamen und den Versionswert unangetastet – die Version muss genau der Quelle entsprechen. Neue Sprache: Lege unter dem neuen Sprachcode den vollständigen Satz an Kategorieverzeichnissen an, damit der Aufbau jede andere Sprache spiegelt, füge die ersten übersetzten Dokumente hinzu und melde die Sprache bei der Veröffentlichungsanwendung an. Ein Sprachordner, der zwar vorhanden, aber nicht angemeldet ist, erzeugt Inhalte, die niemand erreichen kann. Lies vor dem Schreiben einer Übersetzung den sprachraumspezifischen Stilhinweis für diese Sprache, sofern es einen gibt. Solche Hinweise behandeln die Begriffswahl, die Umschrift von Fachbegriffen, die Zeichensetzung und die Höflichkeitsebene, und sie gehen dem allgemeinen Hausstil vor, wo sie sich widersprechen. Wenn es für eine Sprache, in die du übersetzen sollst, keinen solchen Hinweis gibt, schlage vor, einen anzulegen, statt stillschweigend eigene Konventionen zu erfinden. ## Nutze den Statusbericht und bringe zuerst die ältesten Übersetzungen auf den neuesten Stand Das Auseinanderdriften der Übersetzungen ist die übliche Fehlerart einer mehrsprachigen Bibliothek. Steuere bewusst dagegen. Beginne jede Übersetzungssitzung damit, den Statusbericht über die Bibliothek laufen zu lassen, statt Verzeichnisse von Hand zu durchstöbern. Filtere ihn auf die Sprachen, für die du zuständig bist, und auf die Schweregrade, die zählen – ganz fehlende Dokumente und als stark veraltet gekennzeichnete Dokumente kommen zuerst, leichtes Abweichen als Zweites, Abweichungen auf Korrekturstufe zuletzt oder gar nicht. Regeln für die Arbeit: - Übersetze ein Dokument niemals nur teilweise und lasse dabei zugleich die Version mit der Quelle übereinstimmen. Eine halbfertige Übersetzung, die sich selbst als aktuell meldet, ist schlimmer als eine offensichtlich fehlende. - Wenn du auf halbem Weg aufhören musst, belasse die Version auf ihrem vorherigen Wert, damit der Bericht die Datei weiterhin meldet. - Übersetze nicht maschinell und liefere nicht aus, ohne gegen den sprachraumspezifischen Hinweis geprüft zu haben. - Wenn sich die Quelle ändert, nachdem du begonnen hast, prüfe vor dem Abschluss erneut die Unterschiede; schließe gegen die Version ab, die du tatsächlich eintragen wirst. - Berichte am Ende, welche Dokumente du auf den aktuellen Stand gebracht hast, welche du bewusst ausgelassen hast und warum – die nächste mitwirkende Person sortiert danach ihre Arbeit.