Rédaction technique

La rédaction technique exige un travail considérable sur le style. Celui-ci est entièrement soumis à l'objectif utilitaire du texte. Il s'agit de créer des documents qui pourront être lus et compris clairement et sans ambigüité. Tout effet qui attirerait l'attention sur le texte distrait le lecteur et l'éloigne de cet objectif[2]. Les figures de style de la rhétorique sont proscrites, puisqu'il ne s'agit ni de séduire, ni de convaincre ou de persuader, mais de guider une personne qui a déjà choisi d'utiliser l'objet auquel le texte se rapporte. Cette simplicité et cette sobriété exigent un travail sur le style qui peut être ardu (Mallender 2002). Elles n'excluent pas l'exercice d'un jugement esthétique (Charrier 2012, p. 25).Le texte technique est susceptible d'être entendu plutôt que lu, comme c'est le cas lors d'une consultation par téléphone, ou avec les voix synthétiques des ordinateurs pour les mal voyants. Les rédacteurs doivent vérifier que le texte reste parfaitement clair dans ces conditions.

Le style littéraire classique a les mêmes qualités, mais le texte technique doit souvent sacrifier l'élégance au profit de la facilité de compréhension : on répète le mot exact autant de fois que nécessaire, plutôt que d'avoir recours à des pronoms ou à des synonymes.

La grammaire, l’orthographe et la ponctuation ne doivent présenter aucune surprise. En plus des signes conventionnels de l'écriture littéraire, les textes techniques utilisent souvent des artifices de présentation comme les listes à puces, les listes numérotées, les listes de définition. Un petit nombre de pictogrammes et de mises en forme particulières désignent les parties du texte ayant un statut spécial (avertissement, renvoi à une autre partie, explication facultative, par exemple).

Une rédaction technique de qualité doit définir les termes du jargon. Elle peut s'accompagner d'un glossaire. C'est souvent nécessaire quend le public visé est divers, et que des mots font partie du langage courant de certains utilisateurs, mais sont obscurs pour les autres.

Le texte technique prend souvent la forme d'un algorithme décomposant des opérations techniques complexes en une série d’étapes. Suivies patiemment, ces étapes permettent à l’utilisateur d’atteindre l'objectif et de connaître l'état d'avancement de son travail. Les étapes dotées d'un titre mnémotechnique facilitent la reconstitution du cheminement sans consulter le document.

La rédaction technique implique une claire notion du public visé par un document. Une documentation à l’attention de spécialistes hautement qualifiés comportera moins d’explications des termes savants qu’une documentation destinée à un public plus large. Le texte fourni aux utilisateurs doit répondre à leurs difficultés. Une recommandation de bonne pratique préconise de se renseigner sur les attentes effectives d'utilisateurs réels[3]. Si la documentation se construit alors que le produit n'est pas diffusé, on peut utiliser des personnages fictifs, comprenant des éléments de personnalité qui ne soient pas inspirés uniquement par le cahier des charges[4].

Le plus souvent, la documentation technique est multilingue, avec un texte international servant de base, et des versions en langue locale adaptées à chaque pays.

La rédaction technique recherche une présentation claire permettant une lecture et une compréhension plus aisées. Un rédacteur doit comprendre le moyen d’expression utilisé pour percevoir le produit final. Un document HTML, comme une page web, présente très souvent une mise en page différente d’un document imprimé. L’utilisation d’éléments tels que les liens hypertexte et les animations affecteront le fond et la forme de la rédaction.

La rédaction technique est une activité de communication. Les industriels se sont mis d'accord sur de nombreuses normes concernant la conception et la formulation des documents techniques[5]. Plusieurs domaines d'activité, comme l'automobile ou l'aéronautique, mettent en œuvre des normes en vue de présenter partout le même classement des très nombreuses informations qui s'y échangent et une même présentation de ces informations.

La documentation technique comprend deux types de textes qui diffèrent par le style de rédaction, le niveau de connaissance transmis et le public visé :

1. Les documents d’aide à l’utilisateur final aident l’utilisateur à comprendre un produit logiciel ou matériel. Ceci comprend les modes d’emploi pour les programmes informatiques, les produits ménagers, les équipements médicaux, les téléphones mobiles et les autres produits électroniques grand public.
2. La documentation technique traditionnelle communique vers un public spécialisé. Une telle documentation comprend les guides de maintenance, les manuels de réparation, les spécifications techniques, les documents de recherche, les ouvrages de référence, les rapports annuels et les articles de presse spécialisée.

Les types d’outils suivants sont utilisés pour créer et mettre en page des documents techniques :

1. Les outils de gestion de la documentation.
2. Les outils de publication assistée par ordinateur (PAO) ou de traitement de texte produisent des manuels imprimés ou des documents numériques dans un format imprimé. En plus des systèmes courants de traitement de texte, les rédacteurs techniques utilisent des outils « single-source »^[Quoi ?], basés sur le XML notamment. L'automatisation des feuilles de style et d'autres fonctions éditoriales permet l'édition automatique de plusieurs versions, notamment longue ou abrégée, ou bien statique (imprimée) ou dynamique (en ligne). Des outils facilitent la traduction en liant les paragraphes homologues.
3. Les outils de conception d’aide en ligne sont utilisés pour créer des manuels d’aide en ligne, qui peuvent être inclus dans les logiciels, disponibles via un navigateur web ou fournis sous forme de fichiers que l’utilisateur peut lire sur son ordinateur.
4. Les systèmes Wiki sont également utilisés pour produire des documents techniques principalement utilisés en interne mais aussi pour des utilisateurs externes. Mediawiki et Atlassian Confluence sont deux plateformes fréquemment utilisées.

• Alain Charrier, « La rédaction technique : expertise, métier et formation », dans La rédaction technique - Actes du séminaire de Bruxelles des 24 et 25 novembre 1997, De Boeck Supérieur, 2012 (lire en ligne)
• Ariane Mallender, ABC de la rédaction technique : Modes d'emploi, notices d'utilisation, aides en ligne, Paris, Dunod, 2002
• Madeleine Akrich, « Comment décrire les objets techniques », Techniques et cultures,‎ janvier 1987, p. 49-63
• Madeleine Akrich, « Les formes de la rédaction technique », Réseaux, n^o 60,‎ 1993, p. 87-98

• IEEE Transactions on Professional Communication
• Technical writing courses de la Wikiversity
• Fiche métier du rédacteur technique de l'université de Rennes 2

• Rédacteur technique
• Documentation