« On documentera quand on aura le temps. » Cette phrase, entendue dans presque toutes les entreprises, a un coût précis : le jour où la personne qui sait s’absente, part ou oublie, tout le monde le découvre en même temps. La documentation n’est pas de la paperasse : c’est l’assurance continuité de vos processus et de vos automatisations. Encore faut-il documenter la bonne chose, au bon format, sans transformer l’exercice en corvée. Voici comment.
Pourquoi documenter quand tout fonctionne
Toujours documenter : le durable
Le tri est la clé de tout : on ne documente pas tout, on documente ce qui dure. Trois choses, systématiquement.
Les déclencheurs : quel événement précis démarre chaque processus ou workflow, et d’où il vient. Les règles métier : les « quand ceci, alors cela », et surtout leur pourquoi ; la règle sans sa raison sera contournée ou supprimée par le premier qui ne la comprend pas. Les exceptions : les cas particuliers connus et leur traitement prévu ; c’est la partie que tout le monde oublie et celle qui sauve le plus d’heures en cas de pépin.
Pour une automatisation, ajoutez la fiche d’identité minimale : ce que fait le flux, quels outils il touche, où sont les accès, et quoi faire en cas d’incident (qui prévenir, comment couper).
Ne jamais documenter : le volatil et l'évident
La documentation meurt de deux excès. Le premier : documenter le volatil, comme les captures d’écran de chaque clic d’une interface qui changera à la prochaine mise à jour ; ce niveau de détail est périmé avant d’être relu, et il noie le durable. Le second : documenter l’évident, ce que toute personne du métier sait faire ; personne ne lit un mode d’emploi de l’email.
La règle de tri tient en une question : cette information sera-t-elle encore vraie et utile dans un an ? Si oui, elle mérite l’écrit. Si non, elle mérite un format jetable, ou rien.
Les formats efficaces
Le pavé de vingt pages est l’ennemi : il rassure celui qui l’écrit et décourage tous ceux qui devraient le lire. Trois formats font mieux, en moins de temps. La capture annotée : une image de l’écran clé avec trois flèches et deux phrases ; imbattable pour montrer un point précis. Le schéma simple : le flux dessiné du déclencheur au résultat, dans l’esprit de la cartographie, lisible en deux minutes. Et la vidéo courte : trois minutes d’enregistrement d’écran commenté valent souvent dix pages, et se produisent en trois minutes.
Le critère unique reste le même partout : la clarté, pas la quantité. Une page qui répond aux questions réelles bat un classeur exhaustif que personne n’ouvre.
Où la stocker pour qu'elle vive
La maintenir sans corvée
Le cimetière des documentations est pavé de bonnes intentions annuelles. Ce qui marche est plus modeste : la mise à jour au moment du changement, comme un réflexe ; la règle d’équipe tient en une phrase : pas de modification d’un processus ou d’un flux sans sa ligne de documentation. S’y ajoutent un propriétaire par document (quelqu’un qui en répond, pas « tout le monde ») et une revue trimestrielle légère : trente minutes pour dater, dépoussiérer, supprimer ce qui est mort.
Une documentation maintenue ainsi ne coûte presque rien ; c’est la remise à niveau après deux ans d’abandon qui coûte une semaine.
Le test du collègue externe
Comment savoir si votre documentation est bonne ? Un seul test fait foi : donnez-la à quelqu’un qui ne connaît pas le processus, un collègue d’un autre service, un nouvel arrivant, et demandez-lui d’expliquer ou d’exécuter la tâche en s’appuyant uniquement sur l’écrit. S’il y parvient en une heure, votre documentation fonctionne. S’il revient avec dix questions, vous venez d’obtenir gratuitement la liste exacte de ce qui manque.
Ce test vaut aussi pour les documentations livrées par un prestataire : c’est le moyen le plus simple de vérifier qu’on vous a livré un outil de continuité, pas un alibi.
L'écrit est une assurance qui rapporte
Documenter le durable (déclencheurs, règles, exceptions), au format le plus léger qui fonctionne, au plus près de l’usage, avec une mise à jour au fil de l’eau : la discipline tient en une phrase et protège des scénarios les plus coûteux. C’est aussi, très concrètement, la moitié de la valeur d’une maintenance sérieuse : on ne maintient bien que ce qui est compris.
Questions fréquentes
Que faut-il documenter en priorité ?
Le durable : les déclencheurs de chaque processus, les règles métier avec leur pourquoi, et les exceptions connues avec leur traitement. Pour une automatisation, ajoutez la fiche d’identité : ce que fait le flux, les outils touchés, les accès, et la procédure d’incident.
Que ne faut-il pas documenter ?
Le volatil et l’évident : les captures de chaque clic d’une interface qui changera, et ce que toute personne du métier sait déjà faire. Le test de tri : cette information sera-t-elle encore vraie et utile dans un an ? Sinon, format jetable ou rien.
Quels formats de documentation fonctionnent le mieux ?
Les plus légers : la capture d’écran annotée pour un point précis, le schéma simple du flux lisible en deux minutes, la vidéo de trois minutes commentée. Une page qui répond aux vraies questions bat un classeur exhaustif que personne n’ouvre.
Comment maintenir une documentation à jour ?
Par le réflexe plutôt que par la corvée : aucune modification de processus sans sa ligne de documentation, un propriétaire par document, et une revue trimestrielle de trente minutes. Le test de qualité : un collègue externe doit pouvoir comprendre ou exécuter la tâche en une heure.