La documentation technique rate presque toujours au même endroit : elle est organisée comme le produit et non comme le travail. Un manuel qui décrit successivement chaque menu, chaque bouton et chaque voyant est complet, vérifiable, et parfaitement inutile à quelqu'un qui veut changer un filtre. Ce que cherche un lecteur de documentation technique n'est jamais une description, c'est l'accomplissement d'une tâche, et il la cherche dans ses mots à lui, ceux du geste, pas ceux du constructeur. Le rédacteur technique travaille donc en partant de la tâche : il observe ou interroge celui qui fait, il découpe en étapes vérifiables, il place l'avertissement avant le geste dangereux et non après, et il fait valider techniquement ce qu'il a écrit par quelqu'un qui l'a exécuté. Le reste, la mise en forme, est le plus facile.
Ce qu'il fait chaque jour
- Recueillir les tâches à documenterInterroger ceux qui exécutent pour lister ce que la documentation doit couvrir.
- Rédiger les procédures par tâcheÉcrire une action par étape avec son critère de réussite vérifiable.
- Placer les avertissements de sécuritéPositionner chaque consigne avant le geste qu'elle concerne, sans exception.
- Lister les prérequis de chaque procédureAnnoncer outillage, compétences, consignation et durée avant la première étape.
- Faire valider par ceux qui exécutentObtenir la vérification de quelqu'un qui a fait la procédure, et la dater.
- Tenir les indices des documentsGérer version et date d'application de chaque procédure diffusée.
- Signaler ce qu'une évolution rend fauxRelever les passages devenus inexacts après un changement de produit.
Les logiciels qu'il sait tenir
- Microsoft 365
Je rédige les procédures et je tiens les prérequis. - Aletiq
Je récupère les données techniques et je tiens les indices. - Adobe InDesign
Je mets en pages les manuels destinés à l'impression. - Confluence
Je publie les procédures quand elles vivent en ligne. - BlueKanGo
Je verse les procédures validées au système documentaire.
Recrutez votre rédacteur technique
Un entretien d'embauche dans l'application, et il se met au travail chez vous.