Moemu/skills

Normes de rédaction de documentation technique en chinois simplifié

Fusion de quatre références faisant autorité : « Normes de rédaction de documentation technique en chinois » (typographie et structure) de Ruan Yifeng, « Guide de style de localisation chinois (simplifié) » de Microsoft (ton et terminologie de localisation), « Guide de style de rédaction Microsoft » (concepts de rédaction) et ASD-STE100 Simplified Technical English (écriture contrôlée et documentation critique pour la sécurité). Les textes complets des trois premières normes sont sauvegardés dans references/sources/ (les normes de Ruan Yifeng et le Microsoft Writing Style Guide sont des sous-modules Git, à initialiser ; la version convertie du guide chinois de Microsoft est fournie avec le dépôt). Les principes fondamentaux de STE sont résumés dans references/asd-ste100-core.md, et la liste de vérification se trouve dans references/quick-check.md.

Trois concepts de base (voix de Microsoft)

Avant d'écrire chaque phrase, rappelez-vous : L'utilisateur parcourt d'abord le contenu, puis le lit. En général, les lecteurs cherchent une réponse en parcourant le texte, pas en lisant chaque mot.

1. Chaleureux et naturel — Parlez comme à un collègue, pas comme en rédigeant un document officiel. Utilisez le langage courant, évitez le style livresque.
2. Concis et clair — Utilisez des phrases courtes plutôt que longues, supprimez les mots superflus. La brièveté est une qualité.
3. Serviable — Mettez-vous à la place du lecteur, dites-lui quoi faire ensuite, ne vous contentez pas d'énumérer des faits.

Règles typographiques strictes

Ces règles sont presque incontestables et doivent toujours être appliquées lors de la rédaction de contenus techniques en chinois :

Espaces entre le chinois et l'anglais

• Laissez un espace demi-chasse entre les caractères chinois et les mots anglais : 本文介绍如何快速启动 Windows 系统.
• Entre le chinois et les chiffres arabes : L'espace est facultatif, mais l'ensemble du texte doit être uniforme (cette norme recommande d'ajouter un espace).
• Laissez un espace entre les chiffres et les unités anglaises : 16 GB ; pas d'espace entre les chiffres et le signe de pourcentage ou les unités chinoises : 6.5%, 1000 元.
• Pas d'espace entre l'anglais/les chiffres et les signes de ponctuation pleine chasse : 他的电脑是 MacBook Air。 (pas MacBook Air 。)

Signes de ponctuation

• Utilisez la ponctuation pleine chasse dans les phrases chinoises (，。：；？！""''（）、《》) ; utilisez la ponctuation demi-chasse dans les phrases entièrement en anglais.
• Les deux-points : Utilisez le caractère pleine chasse ： dans le corps du document ; utilisez le caractère demi-chasse : (suivi d'un espace) dans les chaînes de l'interface utilisateur, par exemple 错误: %1.
• Point d'interrogation/point d'exclamation : Utilisez les caractères pleine chasse ？！ dans la documentation ; utilisez les caractères demi-chasse ? ! dans l'interface utilisateur.
• Séparez les éléments d'une liste par une virgule de pause chinoise 、, même si les éléments sont en anglais : Google、Facebook、腾讯, reliez le dernier élément par 和.
• Utilisez les guillemets pleine chasse "" pour les citations ; à l'intérieur d'une citation, utilisez des guillemets simples ''.
• Utilisez les parenthèses pleine chasse （） pour les notes explicatives, sans espace avant ou après ; si le contenu entre parenthèses est uniquement en anglais/chiffres, vous pouvez utiliser les parenthèses demi-chasse ().
• Lorsqu'une parenthèse ajoute une note, placez le point en dehors de la parenthèse : 请参照第 1.3 节（见第 26 页）。
• Points de suspension : Utilisez les points de suspension chinois ⋯⋯ (occupant l'espace de deux caractères, six points, n'utilisez pas ... ou 。。。) dans le corps du document ; utilisez les points de suspension anglais ... dans les chaînes de l'interface utilisateur.
• N'utilisez pas les points de suspension avec 等 : soit 香蕉、苹果、梨⋯⋯, soit 香蕉、苹果、梨等水果.
• Évitez les points d'exclamation ; ne les utilisez jamais en double (interdiction de ！！).
• Le tiret long (ou double tiret) doit occuper l'espace de deux caractères chinois : ————.
• Pour les plages de valeurs, utilisez ～ ou — : 132 kg～234 kg ; si les deux nombres ont des unités différentes, chaque nombre doit être accompagné de son unité.
• Utilisez le trait d'union demi-chasse pour les mots composés et les numéros : 氧化-还原反应, 图 1-1.

Nombres

• Utilisez toujours des chiffres demi-chasse, jamais pleine chasse １００.
• À partir du millier, utilisez le séparateur de milliers : 1,258,000 ; facultatif pour les nombres à 4 chiffres, mais l'ensemble du texte doit être uniforme.
• Utilisez le symbole monétaire ou le nom en chinois : $1,000 ou 1,000 美元.
• 增加到 signifie la valeur atteinte, 增加了 signifie l'augmentation ; interdiction d'utiliser 降低 N 倍/减少 N 倍, préférez 降低/减少百分之几.
• Utilisez des quantifieurs spécifiques, évitez d'utiliser systématiquement 个 : 两位研究人员 est meilleur que 2个研究人员.

Phrases et paragraphes

• Faites des phrases aussi courtes que possible : une phrase simple sans ponctuation ne doit pas dépasser 20 caractères, au-delà de 40 caractères c'est inacceptable ; les longues phrases séparées par des virgules ne doivent pas dépasser 100 caractères ou 3 lignes.
• Utilisez des phrases simples et des phrases coordonnées ; évitez les longues propositions subordonnées et les adjectifs trop nombreux avant un nom.
• Utilisez des phrases affirmatives plutôt que négatives : 请确认装置的电源已关闭, pas 请确认没有接通装置的电源.
• Interdiction de la double négation : 用户必须拥有删除权限，才能删除此文件, pas 没有删除权限的用户，不能删除此文件.
• Utilisez la voix active plutôt que la voix passive : 假如尚未安装这个软件, pas 假如此软件尚未被安装.
• Un paragraphe ne doit contenir qu'un seul sujet ; placez la phrase principale en début de paragraphe ; les paragraphes ne doivent pas dépasser 7 lignes, 4 lignes maximum étant l'idéal ; laissez une ligne vide entre les paragraphes, ne commencez pas avec un retrait de première ligne.
• Utilisez correctement 的/地/得 : adjectif + 的 + nom ; adverbe + 地 + verbe ; verbe + 得 + complément.
• Utilisez 的 avec parcimonie : supprimez-le s'il n'affecte pas le sens ; une phrase contenant deux ou trois 的 semble lourde.
• Les pronoms (其/该/此/这) doivent avoir un antécédent unique et clair ; supprimez les pronoms si possible (Microsoft : il n'est pas nécessaire de traduire chaque « your/it » par 你的/它).

Ton et vocabulaire (application de la voix de Microsoft en chinois)

• Utilisez "你" (tu/vous informel) et non "您" (vous formel) — Cohérent dans toute la gamme de produits Microsoft ; amical mais pas condescendant.
• Adressez-vous directement au lecteur, donnez des instructions : 密码有误，请再试一次 est préférable à 密码不正确。请输入正确的密码。
• Évitez les mots trop livresques : utilisez 如果 pas 倘若/假使/若要 ; utilisez 到 pas 至 (添加到网络) ; utilisez 总之 pas 总而言之 ; utilisez 只是 pas 仅是.
• Évitez les mots inventés, les expressions littéraires et le jargon d'Internet : interdiction de 给力、山寨、亲、神马、偶、童鞋、酱紫 ; 粉丝、菜鸟 (limité au contexte du jeu), 量身打造 sont acceptables.
• N'utilisez pas d'adjectifs absolus comme 最好、最强、唯一 (risque juridique selon la loi sur la publicité + exigence de la voix de Microsoft).
• Genre et inclusivité : Évitez 他 (il) pour les références génériques ; utilisez 其, omettez le pronom ou désignez le rôle (读者、用户、客户) ; interdiction des termes discriminatoires comme 剩女、娘炮、老外、残废, utilisez 大龄青年、残障人士、外国人.
• Pour les contenus liés à l'accessibilité, 选择 (sélectionner) est préférable à 点击 (cliquer) pour être compatible avec d'autres méthodes de saisie (clavier, écran tactile, etc.).
• Évitez la traduction mot à mot. Comprenez d'abord le sens global du passage, puis réorganisez les idées comme si vous écriviez vous-même en chinois, en supprimant si nécessaire les modifieurs qui n'affectent pas le sens.

Gestion des termes en anglais et techniques

• La première occurrence d'un terme anglais doit être suivie de sa traduction chinoise entre parenthèses : IOC（International Olympic Committee，国际奥林匹克委员会）, puis utilisez directement l'abréviation.
• Mettez les pluriels anglais au singulier : RAMs → RAM ; les abréviations sont en majuscules.
• Remplacez les guillemets anglais pour les noms de livres/films par des chevrons chinois 《》 ; remplacez ... par ⋯⋯ dans un contexte chinois.
• Ne traduisez pas les noms de produits, marques ou touches : Windows Server 2022 (pas Win Server 2022), Visual Studio 2022 (pas VS 2022) ; les noms de touches comme Ctrl、Alt、Enter、Esc、Tab restent en anglais et ne sont pas suivis du caractère 键 (touche) : 按 Ctrl+Alt+Del.
• Traduisez les touches de direction par 向左键、向上键, etc.
• Format des raccourcis clavier : 翻译文本(&大写字母), par exemple 退出(&E) ; placez-le avant la ponctuation : 搜索(&S):.
• Périodes de la journée : minuit 0:00–5:59, matin 6:00–11:59, midi 12:00–12:59, après-midi 1:00–17:59, soir 18:00–23:59.
• Traduisez un même terme de manière cohérente dans tout le document (app → 应用, application → 应用程序 ; select → 选择, pick → 选取).
• Utilisez 正在… pour le présent continu : Uploading… → 正在上载… ; mais les titres de section Using … sont 使用… pas 正在使用….

Hiérarchie des titres et structure du document

• Utilisez au maximum quatre niveaux de titres ; un titre de niveau 1 ne doit pas être immédiatement suivi d'un titre de niveau 3 ; pas de numéro isolé (si un niveau n'a qu'un seul élément, ne créez pas de palier) ; les titres de niveau inférieur ne doivent pas porter le même nom que leurs titres de niveau supérieur ; évitez autant que possible les titres de niveau 4, utilisez plutôt des listes en gras （1）（2）.
• Ne mettez pas de point, de virgule ou de virgule de pause en fin de titre (le point d'interrogation, le point d'exclamation et les guillemets chevrons sont autorisés).
• Structure recommandée pour un manuel logiciel : Introduction [obligatoire] → Prise en main rapide [facultatif] → Guide du débutant (préparation de l'environnement / installation / configuration) [obligatoire] → Guide avancé [facultatif] → API [facultatif] → FAQ [facultatif] → Annexes (Glossaire/Recettes/Dépannage/Journal des modifications/Commentaires) [facultatif].
• Noms de fichiers : minuscules, demi-chasse, sans espace, séparés par un trait d'union (advanced-usage.md, pas advanced_usage.md ; README, LICENSE font exception et peuvent être en majuscules) ; les noms de fichiers ne doivent pas contenir de caractères chinois.

Texte de l'interface utilisateur et messages d'erreur

• Énoncez d'abord le problème/conclusion, puis l'action ; exprimez une idée par phrase.
• Les fragments de phrase sont plus directs : 步骤如下： est meilleur que 请执行以下步骤： ; 如图所示： est meilleur que 请参阅下面的图像：.
• Utilisez des formulations standard pour les messages d'erreur : Cannot find/Unable to find → 无法… ; 内存不足, pas de traduction littérale comme 没有足够的内存 ; 不可用 → 无法使用….
• Les espaces réservés comme %d/%s ne doivent pas être modifiés, mais la phrase traduite doit rester grammaticalement correcte : %d users are online → %d 位用户在线 (ajoutez un quantifieur).
• Le ton doit être doux et amical, n'accusez pas l'utilisateur, ne faites pas de morale.

Contraintes ASD-STE100 (anglais technique contrôlé)

Applicable aux : documents explicitement tenus de respecter la norme STE (manuels de sécurité critiques pour l'aviation, l'armement, la maintenance mécanique, etc.), aux textes sources en anglais nécessitant un traitement stable par traduction automatique/chaîne de LLM, ainsi qu'à la rédaction de toutes les étapes opérationnelles et consignes de sécurité. Les règles complètes sont disponibles dans references/asd-ste100-core.md (la norme originale est une norme payante soumise au droit d'auteur, seuls les principes fondamentaux sont conservés ici).

Règles strictes pour la rédaction de textes en anglais conformes à la norme STE :

• Utilisez uniquement trois types de vocabulaire : les mots approuvés par le dictionnaire STE (un sens et une fonction grammaticale par mot), les noms techniques (TN) et les verbes techniques (TV) ; les mots ne figurant pas dans le dictionnaire ne peuvent être utilisés que s'ils sont classés comme TN/TV approuvés par l'entreprise/l'industrie.
• Utilisez uniquement les formes simples des verbes : infinitif, impératif, présent simple, passé simple, futur simple, participe passé (uniquement comme adjectif) ; interdiction du présent continu, des temps composés et de l'empilement des auxiliaires ; « -ing » n'est autorisé que comme nom technique ou modifieur de nom technique.
• Les noms composés sont limités à 3 mots maximum ; pour les noms plus longs, écrivez d'abord la forme complète puis donnez l'abréviation ou ajoutez un trait d'union.
• Utilisez l'orthographe américaine ; interdiction des formes contractées (do not pas don't) ; interdiction du point-virgule ; n'omettez pas le sujet, le verbe ou l'article ; les termes et formulations doivent toujours être cohérents.

Lors de la rédaction d'étapes opérationnelles et de consignes de sécurité (applicable en chinois et en anglais, c'est la contribution la plus universelle de STE à cette compétence) :

• Une action par phrase ; énoncez d'abord la condition, séparez-la par une virgule, puis donnez l'ordre.
• Remplacez les longues phrases complexes par des listes verticales ; les Notes ne doivent contenir que des informations, pas d'instructions.
• Structure des consignes de sécurité en trois parties : WARNING (risque de blessure ou de mort) / CAUTION (risque de dommage matériel) + ordre ou condition + conséquence du risque ; choisir le mauvais niveau est pire que de ne pas en écrire ; si les deux types de risques sont présents, passez au niveau WARNING.
• Dans le texte descriptif : chaque phrase ≤ 25 mots, chaque paragraphe ≤ 6 phrases, un sujet par paragraphe, les informations sont données progressivement.

Les règles de vocabulaire STE ne s'appliquent pas au chinois, mais leur esprit est intégré dans les autres sections de cette compétence : termes uniques, phrases courtes quantifiées (texte procédural ≤ 20 mots → chaque étape en chinois = une action), éviter la nominalisation (« 进行检查 » (procéder à une vérification) → « 检查 » (vérifier)), diviser les phrases sans supprimer de mots.

Arbitrage des conflits (lorsque plusieurs normes sont en désaccord)

1. Priorité au contexte : Documentation technique/tutoriel/README → suivez les normes documentaires (ponctuation pleine chasse, points de suspension ⋯⋯) ; chaînes d'interface utilisateur/messages d'erreur → suivez les normes logicielles (deux-points demi-chasse + espace, ? ! demi-chasse, points de suspension ...).
2. Priorité à la conformité STE : Pour les textes en anglais explicitement tenus de respecter la norme STE, les 53 règles de STE prévalent (vocabulaire, temps, longueur de phrase) ; la voix de Microsoft et les normes générales de l'anglais leur sont subordonnées.
3. La cohérence prime sur les préférences personnelles : espace ou non entre les chiffres et le chinois, séparateur de milliers pour les nombres à 4 chiffres ou non ; lorsque la norme autorise une option, choisissez-en une et appliquez-la à l'ensemble du texte.
4. La lisibilité prime sur la correspondance littérale : réécrivez si la traduction littérale est peu naturelle (la voix de Microsoft autorise explicitement la réécriture) ; pour les conflits spécifiques (points de suspension vs 等, 至, etc.), suivez les « Règles strictes » ci-dessus (dans le contexte documentaire, les normes de Ruan Yifeng prévalent).
5. Pour les cas non prévus par cette norme, consultez dans l'ordre : references/quick-check.md → references/asd-ste100-core.md → les textes originaux dans references/sources/ (dont deux sous-modules à initialiser).

Processus de révision

Avant de livrer un document technique en chinois, vérifiez-le dans l'ordre suivant :

1. Typographie : espaces entre le chinois et l'anglais, ponctuation pleine chasse / demi-chasse, séparateur de milliers.
2. Phrases : divisez les phrases longues, remplacez les formes négatives par des affirmatives, la voix passive par la voix active, éliminez les doubles négations.
3. Ton : 您 → 你, oralisez le style livresque, supprimez les 的 superflus, vérifiez les références des pronoms.
4. Terminologie : notez en parenthèses la traduction à la première occurrence, unifiez les traductions, assurez-vous que les noms de produits et de touches ne sont pas traduits.
5. Structure : hiérarchie des titres valide, un sujet unique par paragraphe, noms de fichiers conformes.

Un tableau comparatif détaillé des erreurs courantes et de leurs corrections se trouve dans references/quick-check.md.