Die 10 Gebote des Technical Writing für Entwickler

<p>- Wesentliche Satzbestandteile nicht auslassen<br /> - Auf die grammatische Übereinstimmung der Satzbestandteile achten<br /> - Partikeln korrekt verwenden<br /> - Passiv- und Kausativformen möglichst vermeiden<br /> - Doppelte Verneinungen vermeiden<br /> - Klare Formulierungen verwenden<br /> - Reihenfolge und Aufzählungen unterscheiden<br /> - Stichpunktstil nutzen<br /> - Rechtschreibung und Abstände prüfen<br /> - Die Schreibweise von Fremdwörtern prüfen</p>

[xguru]

<p>- Die vier Grundprinzipien des technischen Schreibens https://de.news.hada.io/topic?id=5409<br /> - Die Kunst der Überarbeitung – So schreiben Entwickler technische Dokumentation https://de.news.hada.io/topic?id=5446</p&gt;

[hongminhee]

<p>Für Programmierer gilt bei der Transkription von Fremdwörtern de facto, dass man nur auf Englisch achten muss. Wichtig ist dabei, dass sich die koreanischen Regeln zur Schreibung von Fremdwörtern nicht an der Orthografie, sondern an der tatsächlichen Aussprache orientieren, und dass im Englischen die Schreibweise die Aussprache nicht zuverlässig widerspiegelt. Wenn man also nicht die Schreibweise eines Wortes, sondern seine Lautschrift als Grundlage nimmt, macht man weniger Fehler.<br /> <br /> Wenn man sich nicht sicher ist, kann man 1) das betreffende englische Wort einfach im koreanischen Wörterbuch nachschlagen und, falls es dort steht, diese Form verwenden, und 2) wenn es nicht vorkommt, das Wort im englischen Wörterbuch nachschlagen und anhand der internationalen Lautschrift (IPA) die Schreibung ableiten. Allerdings orientieren sich die Regeln zur Fremdwortschreibung im Englischen an der britischen Aussprache, weshalb es gelegentlich auch zu unerwarteten Schreibungen kommt.<br /> <br /> Wenn es nicht um Englisch geht, ist etwas wie Hangulize (https://hangulize.org/) praktisch. Da die englische Orthografie jedoch chaotisch ist, lässt sich das nicht so mechanisch anwenden, und man braucht unbedingt ein Wörterbuch. (Bei Neologismen etwa sind Einträge oft noch nicht im Wörterbuch vorhanden, sodass man manchmal auf YouTube oder ähnlichen Plattformen nachsehen muss, wie die Leute das betreffende Wort tatsächlich aussprechen.)</p>