Les 10 commandements de l’écriture technique pour les développeurs

<p>- Ne pas omettre les éléments indispensables de la phrase<br /> - Respecter la concordance des éléments de la phrase<br /> - Utiliser correctement les particules grammaticales<br /> - Éviter les formes passives et causatives<br /> - Éviter les doubles négations<br /> - Utiliser des formulations claires<br /> - Distinguer l’ordre et les listes<br /> - Utiliser le style en points clés<br /> - Vérifier l’orthographe et les espaces<br /> - Vérifier la transcription des mots d’origine étrangère</p>

[xguru]

<p>- Les 4 grands principes de la rédaction technique https://fr.news.hada.io/topic?id=5409<br /> - L’art de la révision - Comment rédiger une documentation technique pour les développeurs https://fr.news.hada.io/topic?id=5446</p&gt;

[hongminhee]

<p>Pour les programmeurs, en pratique, il suffit surtout de faire attention à la translittération des mots d’origine étrangère depuis l’anglais. Il faut toutefois garder à l’esprit que, dans les règles coréennes de transcription des mots étrangers, on se base non pas sur l’orthographe mais sur la prononciation réelle, et que l’anglais ne reflète pas correctement la prononciation dans son orthographe ; il faut donc transcrire à partir de la notation phonétique plutôt qu’à partir de l’orthographe du mot, ce qui permet d’éviter bien des erreurs.<br /> <br /> En cas de doute, 1) cherchez simplement le mot anglais en question dans un dictionnaire coréen et, s’il y figure, utilisez cette forme ; 2) s’il n’y figure pas, cherchez-le dans un dictionnaire anglais, consultez l’alphabet phonétique international (IPA) et déduisez-en la transcription. Cela dit, les règles de transcription des mots étrangers prennent, pour l’anglais, la prononciation britannique comme référence ; il arrive donc assez souvent de tomber sur des graphies inattendues.<br /> <br /> Si ce n’est pas de l’anglais, utiliser un service comme Hangulize (https://hangulize.org/) est pratique. En revanche, comme l’orthographe anglaise est très irrégulière, il est difficile d’appliquer ce type de procédé de manière mécanique, et un dictionnaire est indispensable. (Dans le cas de néologismes, par exemple, il arrive aussi qu’ils ne soient pas encore enregistrés dans les dictionnaires ; il faut alors parfois vérifier sur YouTube ou ailleurs comment les gens prononcent réellement le mot.)</p>