Arbeit mit Texten
Klare technische Texte: Handlung, Bedingung und Prüfung
Wie Sie Anleitungen und Projektbeschreibungen so schreiben, dass Leser die Aufgabe und den nächsten Schritt verstehen.
Eine gute Anleitung hilft, eine Handlung auszuführen und das Ergebnis zu prüfen. Eine gute Projektbeschreibung erklärt die Aufgabe, den Beitrag des Autors und den aktuellen Status. Ein kurzer Text ist nur dann nützlich, wenn er die benötigten Informationen enthält.
In dieser Praxis verbinde ich klare Sprache mit Prinzipien des technischen Schreibens aus ASD-STE100 und dem Ansatz von William Zinsser. Das ist eine redaktionelle Grundlage. Sie belegt keine Konformität russischer oder deutscher Texte mit dem englischen Standard. Dessen Wortschatz und Grammatikregeln lassen sich nicht mechanisch auf andere Sprachen übertragen.
Mit der Aufgabe der Leser beginnen
Beantworten Sie vor der Überarbeitung drei Fragen: Wer braucht den Text, was soll diese Person verstehen und was soll sie danach tun können? In einer Anleitung für Berufseinsteiger müssen Sie ein Werkzeug erklären. Für erfahrene Fachkräfte kann eine kurze Checkliste genügen.
Statt „Sehen Sie sich die Anfrage in DevTools an“ beschreiben Sie die Schritte für den gewählten Browser: „Drücken Sie in Chrome unter Windows F12. Öffnen Sie den Tab Network. Wiederholen Sie die Aktion auf der Seite und suchen Sie die Anfrage.“ Nennen Sie anschließend das Feld oder den Wert, den die Person prüfen soll. Elementnamen können sich ändern. Gleichen Sie sie mit der verwendeten Version ab.
Handlung und ausführende Person nennen
„Es erfolgt eine Prüfung der Einstellungen“ sagt nicht, wer was prüft. Klarer ist: „Vor dem Start prüft der Administrator die Dienstadresse und die Rechte des Benutzerkontos.“ Formulieren Sie einen Anleitungsschritt als direkte Aufforderung: „Prüfen Sie die Dienstadresse.“
Ein Anleitungsschritt enthält gewöhnlich eine Handlung. Eine Bedingung, die den Ablauf verändert, steht vor der Handlung: „Wenn die Anfrage mit einem Fehler endet, speichern Sie den Fehlercode. Prüfen Sie anschließend das Protokoll.“ Entfernen Sie die Bedingung nicht nur, um den Satz zu kürzen.
Begriffe einheitlich verwenden
Wählen Sie für eine Entität eine Bezeichnung. Heißt ein Objekt in der Oberfläche „Besprechungsraum“, nennen Sie es in den folgenden Schritten nicht abwechselnd Raum, Ressource und Zimmer. Erklären Sie einen Fachbegriff bei der ersten Verwendung und verwenden Sie ihn danach einheitlich.
Ein Link soll das Dokument oder das erwartete Ergebnis nennen. „API-Dokumentation“ hilft mehr als „hier“. Übernehmen Sie Code, Pfade, Kennungen und Schaltflächennamen genau. Sie dürfen nicht aus sprachlichen Gründen verändert werden.
Beitrag und Ergebnis unterscheiden
Zeigen Sie in einer Beschreibung Ihrer Erfahrung, was Sie selbst getan haben, was das Team umgesetzt hat und was noch läuft. „Ich klärte die Anforderungen und wirkte an der Überarbeitung der Architektur mit. Das Team setzte die wesentlichen Prozesse um.“ So bleibt der Umfang des eigenen Beitrags erkennbar.
Ein Einführungsplan ist noch keine abgeschlossene Einführung. Beschreiben Sie den geplanten Umfang nicht als Ergebnis. Wenn Sie ein literarisches Bild verwenden, kennzeichnen Sie es als solches und ergänzen Sie eine sachliche Beschreibung.
Übersetzungen berücksichtigen
Für Englisch, Deutsch und Spanisch gelten dieselben Ziele: Leser finden die gesuchten Informationen, verstehen die Bedingungen und erkennen den nächsten Schritt. Verwenden Sie die natürliche Grammatik jeder Sprache. Übernehmen Sie die russische Satzstruktur nicht wörtlich.
Vermeiden Sie Formulierungen, deren Bedeutung von einem lokalen Witz oder einer Redewendung abhängt. Behalten Sie Produktbegriffe, Versionsnummern und Links bei. Prüfen Sie die Länge von Beschriftungen: Ein deutsches Menü benötigt oft mehr Platz. Verständliche Texte für eine breite Zielgruppe und formal geregelte Leichte Sprache sind unterschiedliche Aufgaben.
Den Text bei der Nutzung prüfen
Geben Sie die Anleitung einer Person, die die Aufgabe nicht kennt. Bitten Sie sie, den benötigten Schritt zu finden und das Ergebnis zu erklären. Notieren Sie ihre Fragen. Versteht sie die Wörter, weiß aber nicht, was sie tun soll, ergänzen Sie den Inhalt. Kürzere Sätze allein lösen das Problem nicht.
Für eine Projektbeschreibung gilt eine andere Prüfung: Kann der Leser ohne zusätzliche Erklärung die Aufgabe, Ihren Beitrag und den Status nennen? Wenn nicht, verbessern Sie zuerst diese Teile.
Quellen
- ASD-STE100: Zweck und Grenzen.
- William Zinsser: Writing English as a Second Language.
- Google: Texte für eine internationale Zielgruppe.
Die redaktionellen Regeln dieser Website beruhen auf dem vom Autor bereitgestellten russischen Leitfaden „Klarheit als Arbeitswerkzeug“ vom 3. Oktober 2026.