Rédiger des manuels techniques faciles à suivre et à traduire

## Écrire des phrases courtes pour les tâches du lecteur, avec un terme par idée - Identifiez le lectorat visé, ses connaissances, ses tâches et ses questions ; expliquez les compromis lorsque plusieurs choix sont possibles. - Employez des phrases courtes et complètes, la voix active, le présent et des verbes à l’impératif pour les procédures. - Employez un seul terme par concept ; définissez les termes inconnus et les abréviations, et évitez les expressions idiomatiques, l’argot, les stéréotypes et les analogies locales. ## Recopier exactement commandes et noms, et séparer notes et avertissements - Préservez exactement les identifiants littéraux, y compris leur casse ; distinguez les commandes, les noms de fichiers, les chemins, les libellés d’interface et le texte courant sans vous appuyer uniquement sur la typographie. - Utilisez des exemples pertinents ; excluez les comptes réels, les identifiants d’accès et les données personnelles, et expliquez l’objectif de tout élément sensible à la langue ou à la région. - Distinguez les notes destinées au contexte important, les précautions en cas d’impact sérieux et les avertissements en cas de conséquences critiques. ## Garder listes et tableaux cohérents et préciser unités et dates - Faites en sorte que les titres résument le contenu, introduisez clairement les listes, gardez les éléments parallèles et ne numérotez que les séquences, les priorités ou les hiérarchies. - Gardez les tableaux simples ; indiquez les unités, préférez le SI, utilisez les chiffres de façon cohérente et rendez explicites les dates, les heures, les plages et les fuseaux horaires. - Utilisez des renvois précis et stables plutôt que des numéros de page codés en dur ; gardez les définitions autonomes et révisez de façon cohérente la terminologie, l’inclusivité, les mentions légales et les marques commerciales.