Un manuel d'équipe doit aider quelqu'un à accomplir une tâche, et pas seulement prouver qu'un document existe. Commencez par une procédure récurrente et un lecteur qui ne connaît pas votre vocabulaire interne.
Choisissez un exemple sans enjeu : la préparation des fichiers approuvés pour une séance d'atelier. L'objectif est un dossier clairement identifié, et non une description de tout ce que fait l'entreprise.
Définir la fonction de la page
Indiquez qui utilise la page, ce dont il a besoin avant de commencer et le résultat visible. Limitez la page à une seule procédure, sauf si des actions étroitement liées doivent être expliquées ensemble.
Utilisez cette structure :
Objectif : préparer les supports d'atelier approuvés. Avant de commencer : accès au dossier actif et identifiant de la séance. Actions : trouver, examiner, rassembler et transmettre les fichiers. Fin : le destinataire peut identifier le bon dossier. Responsable : la personne qui approuve les modifications de cette procédure.
Expliciter les connaissances implicites
Repérez les termes que seuls les collègues expérimentés comprennent. Indiquez l'emplacement réel ou la règle de décision plutôt que d'écrire « utilisez le fichier habituel ». Si une étape nécessite une autorisation, expliquez qui peut l'accorder.
Associez les captures d'écran à la version du logiciel et à la date de révision. Une image est utile lorsqu'elle montre quelque chose que le lecteur doit reconnaître ; elle ne remplace pas la description de l'action.
Rendre les mises à jour traçables
Attribuez à la page un responsable, un statut d'approbation et un déclencheur de révision. Une procédure peut devoir être vérifiée lorsqu'un outil change ou lorsque l'entreprise modifie son processus. Indiquez ce que la nouvelle version remplace.
Si la page contient des questions non résolues, signalez-les de façon visible. Ne faites pas passer un brouillon pour une version approuvée simplement pour que le manuel reste bien ordonné.
Essayer un exercice avec un nouvel arrivant
Confiez la page à une personne qui ne connaît pas la tâche et laissez-la travailler sur des fichiers d'exemple sans risque. Ne la guidez pas à travers chaque étape implicite. Notez les moments où elle hésite, pose une question ou choisit le mauvais fichier.
Utilisez ces observations pour améliorer les instructions et refaites la partie concernée. Un manuel devient utile grâce à ce travail de vérification et de maintenance. Il n'a pas besoin de prétendre que toutes les connaissances de l'entreprise sont automatiquement recherchées ou tenues à jour par l'IA.
Mika est un nom de plume éditorial utilisé par l'équipe de rédaction de KENJTEC à Hambourg. Cet article propose une méthode de travail ; il ne rend pas compte d'un test réalisé.
